[drupal-docs] Tag handbook pages with major versions

[Charlie Lowe]

Version tagging is a great idea. But before we jump into this, there are 
a few things we ought to talk about:

1) Freetagging has hit core. Do we want to use the traditional taxonomy 
setup or use freetagging so that book maintainers can easily add 
additional categories?

2) Feature freeze is only a week away. Starting within the next few 
weeks, our main priority has to be updating admin/help documentation, 
and if time and resources permit, review subpages for admin 
documentation to make sure that they are up-to-date and do some 
refining. If we have a tagging solution/standard ready by then (written 
up and posted in the handbook), we can easily--and should--tag the 
configuration docs as they are reviewed. But updating the configuration 
documentation has to take priority.  We can see this need in the URL 
that Dries recently shared:

http://woffling.blogspot.com/2005/09/quite-fond-of-drupal-now.html

3) It's not going to be that easy to just divide up all of the handbook 
pages and tag them all. Many of the handbook pages will require 
expertise to evaluate and/or testing of content to verify which versions 
the documentation applies to. Deciding who has that expertise and who is 
willing to do the testing creates a lot of organizational management 
overhead. We need a volunteer to manage this and find volunteers to do 
the tagging, and it would have to wait to begin until after the 
documentation sprint is finished.

Kieran Lal wrote:
> How many pages in the handbook, times how long it takes to tag each  
> page.  Divide by the active number of Drupal Docs team members.
> 
> Then let's be upfront about how much work this project is and who is  
> going to do it.
> 
> Kieran
> On Sep 7, 2005, at 2:54 PM, Karoly Negyesi wrote:
> 
>> Hi!
>>
>> Let's create terms for each major version (DRUPAL-4-5, DRUPAL-4-6,  
>> DRUPAL-4-7...) and tag the handbook pages. There could be better,  
>> more comprehensive etc etc solutions but this has a big advantage:  
>> easy to implement. The handbook heads to uselessness as there are  
>> pages from 4.3 to 4.7 and everything in between.
>>
>> Regards
>>
>> NK
>> -- 
>> [ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]
>>
>>
>