[drupal-devel] Admin Help writing instructions - 60 patches coming soon

[Kieran Lal]

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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://drupal3.drupal.org/pipermail/development/attachments/20050517/062e8afd/attachment.htm