Yeah, well, this debate looks interesting, because the Drupal community is going to have to decide what approach to take towards their documentation: a free-style approach (what has been done up till now) or a more industry-standard, versioned, multi-output one.
<br><br>Or,.... (and I think this is Steven's idea): both!<br><br>The free-style approach will continue, but the best of that could be abstracted into the versioned, industry standard documentation. Then we can have the best of all possible worlds, and instead of being dependent upon individuals, we can be dependent upon process!
<br><br>saludos,<br><br>Victor Kane<br><a href="http://awebfactory.com.ar">http://awebfactory.com.ar</a><br><br><div><span class="gmail_quote">On 8/23/07, <b class="gmail_sendername">add1sun</b> <<a href="mailto:drupal@rocktreesky.com">
drupal@rocktreesky.com</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div style=""><br><div><span class="q"><div>On Aug 22, 2007, at 11:32 PM, Victor Kane wrote:
</div><br><blockquote type="cite"><br><br><div><span class="gmail_quote">On 8/22/07, <b class="gmail_sendername">add1sun</b> <<a href="mailto:drupal@rocktreesky.com" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
drupal@rocktreesky.com</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"> ...</blockquote><br></div></blockquote><div><br>
</div></span>-snip-<span class="q"><br><blockquote type="cite"><div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"> since it will be in<br>
DocBook format and in CVS - not normal handbook pages. Replicating<br>the entire community-contributed handbook for each version is really<br>not feasible at this time. ...</blockquote><div><br></div> </div>Some of that work can be automated, and that might make it feasible. There are many available DocBook editors and tools, also.
<br></blockquote><div><br></div></span>Well those two sentences are not as related as it may seem. We will not move the normal, community contributed docs to DocBook/CVS, not because of automation or whatnot, but because it will *severely* limit the number of people who will contribute to documentation. Right now any user can create a page by clicking an Add Child Page link and Docs maintainers can easily edit pages from directly in the handbook. If we suddenly made everyone use CVS and DocBook (even only one of those is enough to kill help, but combined it is a massive hurdle) for the whole handbook, we will get even fewer people to help/contribute than now (and since the number now is crazy teeny, tiny we really can't afford that.) So when I say replicate "community-contributed" I mean actually creating/splitting handbook pages in the current Drupal book content type way - not DocBook.
<br></div><div><blockquote type="cite"><span class="q"><br>saludos,<br><br>Victor Kane<br><a href="http://awebfactory.com.ar" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">http://awebfactory.com.ar
</a><br></span><span class="q"><div style="margin: 0px;">--</div><div style="margin: 0px;">Pending work: <a href="http://drupal.org/project/issues/documentation/" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
http://drupal.org/project/issues/documentation/</a></div><div style="margin: 0px;">List archives: <a href="http://lists.drupal.org/pipermail/documentation/" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
http://lists.drupal.org/pipermail/documentation/</a></div> </span></blockquote></div><br></div><br>--<br>Pending work: <a onclick="return top.js.OpenExtLink(window,event,this)" href="http://drupal.org/project/issues/documentation/" target="_blank">
http://drupal.org/project/issues/documentation/</a><br>List archives: <a onclick="return top.js.OpenExtLink(window,event,this)" href="http://lists.drupal.org/pipermail/documentation/" target="_blank">http://lists.drupal.org/pipermail/documentation/
</a><br></blockquote></div><br>