<div style="font-size: 30px;" id="RTEContent">Exactly! Having a single document to deal with would bring significant advantages.<br style="font-size: 30px;"> <br style="font-size: 30px;"> With the new workflow options available (?) in 4.7, we could even make this entire process part of a workflow:<br style="font-size: 30px;"> <br style="font-size: 30px;"> 1.) Developers fill in the initial documentation in the project fields provided and it goes into install.txt in CVS and the tarballs. To avoid developer resistance, we could make a minimum set of fields required and the rest, not required.<br style="font-size: 30px;"> <br style="font-size: 30px;"> 2.) This text then goes to people/volunteers on the docs list who install the modules and document its various intricacies. Then, with access to the same form fields as the developers, they add the extra stuff they have documented.<br style="font-size: 30px;"> <br style="font-size: 30px;"> 3.) Someone (or a set of
people
if possible, including the developers), reviews the additions and approves them. On approval, the new text gets added to the CVS and module tarballs with the PHP magic you mentioned.<br style="font-size: 30px;"> <br style="font-size: 30px;"> 4.) Finally, this approved documentation is also automatically added to the drupal.org handbooks<br style="font-size: 30px;"> <br style="font-size: 30px;"> If this makes sense (not too bureaucratic etc.) and is technically feasible, I will compile all the suggestions people have made till now for a standard format. <br style="font-size: 30px;"> <br> The drupal.org handbooks can still be the place for more detailed documentation, child pages, tips and tricks stuff etc.<br> <br> Ramdak<br style="font-size: 30px;"> <br style="font-size: 30px;"> <br style="font-size: 30px;"><br style="font-size: 30px;"><b style="font-size: 30px;"><i style="font-size: 30px;">Charlie Lowe <cel4145@cyberdash.com></i></b> wrote:<blockqu
ote
class="replbq" style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; padding-left: 5px; font-size: 30px;"> <br style="font-size: 30px;">But this did make me think of one idea. Not sure how hard this is to do, <br style="font-size: 30px;">but for each module, could we use PHP to pull in the install.txt from <br style="font-size: 30px;">CVS as a sub-page of the main module page in the "Drupal modules and <br style="font-size: 30px;">features" handbook? Either that, or have the actual project module page <br style="font-size: 30px;">automatically pull install.txt from CVS and include it as a link? We <br style="font-size: 30px;">could then help module developers to provide better install.txt files <br style="font-size: 30px;">and focus on what information needs to be provided there. Only one <br style="font-size: 30px;">document to maintain, too.<br style="font-size: 30px;">--<br style="font-size: 30px;">Pending work: http://drupal.org/project/issues/documentation
/<br
style="font-size: 30px;">List archives: http://lists.drupal.org/pipermail/documentation/<br style="font-size: 30px;"></blockquote><br style="font-size: 30px;"></div><p>
                <hr size=1>Yahoo! Photos<br>
Ring in the New Year with <a href="http://us.rd.yahoo.com/mail_us/taglines/photos/*http://pa.yahoo.com/*http://us.rd.yahoo.com/mail_us/taglines/photos/evt=38087/*http://pg.photos.yahoo.com/ph//page?.file=calendar_splash.html&.dir=">Photo Calendars</a>. Add photos, events, holidays, whatever.