[drupal-docs] Tag handbook pages with major versions

Bèr Kessels berdrupal at tiscali.be
Thu Sep 8 19:51:10 UTC 2005


I am proposing that we use taxonomy (or tagging, if you prefer that term) for 
the books. 

Then a book page will just show: 
----------------------------------------------------------------------
Make a Foo in a Bar               Release 4.6 | Release 4.5
By John Doe .... 
Lorem ipsum .....
----------------------------------------------------------------------

Simple. 
And when the page does not, or no longer apply to 4.5 that term is deselected. 
When itis upgraded to work for 4.7, the 'Release 4.7' term is selected.

Nothing with shadow books, fallbacks, revisions etc. KISS, please.


Op donderdag 08 september 2005 09:09, schreef puregin:
> On 7 Sep 2005, at 7:37 PM, Charlie Lowe wrote:
> > Version tagging is a great idea. But before we jump into this,
> > there are a few things we ought to talk about:
>
> This begs the question, 'how will tagging be used?'
>
>    Do we want to be able to select a Drupal version and see the
> handbook corresponding to our selection?
>
>    How will book structure and taxonomy interact?
>
>    How will 'missing' content be handled?  For example, if there is
> no content for 'administering blocks' tagged for 4.6, do we display a
> blank page?  Give a warning and fall back to an earlier version?  How
> will book navigation work?
>
>    Or perhaps we just want to be able to display all tags associated
> with the page.
>
>    I guess all of this is to say - I'm a bit uneasy that we're
> grasping at tagging to try to impose some external structure on
> documentation which is in parts fundamentally lacking in cohesion
> (pardon me for saying so).
>
> As far as versioning goes, I think it's a great idea.  But versioning
> by tagging seems to be the wrong approach.  How would we handle
> branches?  What about content that is independent of version?
>
>      Djun
Regards,
 Bèr
-- 
 [ Bèr Kessels | Drupal services www.webschuur.com ]



More information about the drupal-docs mailing list