[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