On May 16, 2005, at 11:04 PM, Gerhard Killesreiter wrote:
Where will those pages reside? Is there any plan for this?
We still should have a solution for this before the help pages are changed.
My revisions patch will make keeping revisioned information through Drupal somewhat easier. I think that it would be possible to extend it further to also allow for branches. This could help to keep documentation for different branches of Drupal up to date.
I don't think we addressed your question adequately yet. I don't know anything about your revisions patch. But there has been great resistance, by which I mean lack of enthusiasm, for formal revision management of documentation. I suspect that it's hard to imagine doing revisions if you haven't written it first. Or it could be that revision tools are believed to be too intimidating. I think that one way of managing the different revisions is right under our noses. Taxonomies, and their young trendy cousin folksonomies. For example, I have been looking at wordpress's documentation site. http://codex.wordpress.org/Category:Stubs http://codex.wordpress.org/Category:Copyedits Perhaps we could set up a taxonomy for the handbook and then allow the docs team and the translation team to tag documents with version numbers, and translations. At the same time we could enable, folksonomies which I haven't used, and allow visitors to Drupal.org to tag forum topics, documentation, and content with tags. I think this best reflects the situation we are in. We have a small team of documenters trying to categorize and produce documentation, then a team of translators who need figure out what they should translate, and finally a large community that could do a lot of the weeding for us. I'll move this idea over to Drupal docs shortly. Cheers, Kieran