[drupal-docs] Next steps

[bryan kennedy]

On Apr 27, 2005, at 11:04 AM, Charlie Lowe wrote:
> Two problems:
>
> 1) link rot
Actually that is why I wanted to do it on drupal.org so that nothing 
would suffer from link rot.  In our new handbook all links to handbook 
content would be internal to the new handbook.  It wouldn't link to the 
old handbook pages ever.  Once the new book was ready for prime-time it 
would just be linked up as the main handbook and the old frozen one 
would be deleted.

> 2) if by "un-promoted" you mean "un-published," I just had some
> experience with Drupal 4.5 with this. In 4.5, book pages which are not
> yet published do not show up in the "Parent" pull down menu. If this
> still works this way in 4.6, it would be impossible to organize the
> pages as they were created.

No, I mean un-promoted.  You are correct that un-published material 
wouldn't work for the reasons you mentioned.  The new books we would 
work on would just be unlinked from anywhere public on the site.  You 
would have to know to goto drupal.org/handbook-development

>
> I believe others have proposed previously that we reauthor the pages on
> a wiki. We can then move them over as completed by replacing existing
> pages where possible (to prevent link rot). Cutting and pasting would
> not be that hard, and indeed, would allow for a rolling update of the
> handbook as sections are revised rather than waiting until everything 
> is
> completed.

I actually think this will create link rot.  If we create everything in 
a wiki then we don't have the structure imposed by the book module.  
Then we have to re-find all the links as we move pages over since the 
wiki will not create node's defined in the book structure.  If the 
final destination is a book on drupal.org then let's author in a book 
on drupal.org.  If this isn't possible then let's at least author in a 
drupal site running the book.module with a protected chunk of node 
numbers, so that we can move it over to drupal.org once it is ready 
without having to re-write links.

> -1
>
> There's an automated system for this already using profiles. Meanwhile,
> it would be inconsiderate and inappropriate, I think, to list the
> revising author and not list all the other authors who have worked on
> the text. Attribution is best left, IMHO, to a listing in the copyright
> and licensing section.
>
Oh yeah, I guess I agree with you.  I just sorta described it poorly.  
Yep, what you said.

----
I know I am sorta talking out in la-la land where I don't actually have 
to make this happen on drupal.org.  So if this won't work let's just 
author in a book.module somewhere else.  But I think it would be a bad 
idea to author in a wiki since the end product won't be a wiki.