[drupal-docs] Idea - move help text out of code into database

bryan kennedy digital at mysteryexperience.com
Sat May 14 05:06:04 UTC 2005


I am replying to various points outlined in the previous comments.  I  
think:

     -Rewriting the handbook inside the current structure will lead  
to a slow tedious process.
         -This process will still create dead links since we are  
restructuring not just re-writing.  Pages will move, whole sections  
will disappear.
     -We need to be able to work on a fresh copy that is advertised  
as unfinished.
     -I think (and have suggested) we should freeze the current  
handbook.
         -Yes, that means that if you see an error it will go unfixed.
         -That error or new documentation will be built into the new  
handbook.
     -Once this handbook is at a acceptable level of completeness, it  
will become the new handbook
         -Over the period of a weekend (or some other very short  
period of time) we will fix all the links (aliases) to the old  
handbook to appropriate new content.

Have we reached any sort of consensus?  No.  Are we re-hashing the  
same issues of processes over and over and coming no closer to a  
decision?  Yes.  Does it matter.  Well, probably not.  People are  
working within the current handbook structure to improve the content  
and people are working in the new handbook structure to build new  
content.  Either way that's progress.  At some point the Document  
Team Leader(s) will have to make a decision and implement a  
workflow.  Until then we DO seem to be making progress toward a  
better handbook.

bryan



More information about the drupal-docs mailing list