[drupal-docs] supplying version number for handbook pages
Charlie Lowe
cel4145 at cyberdash.com
Sat Nov 5 15:09:55 UTC 2005
Angie Byron wrote:
> Charlie Lowe wrote:
>
>
>>So in order to make sure that the version information can be provided as
>>easily as possible, i believe that tagging is going to be our best
>>solution.
>>
>>For tagging, how about: Drupal 4.6, Drupal 4.7, etc.
>>
>>Any suggestions?
>
>
> First, a couple questions and then hopefully some suggestions. :)
>
> By "tagging" do you mean creating a taxonomy drop-down for book content where
> you can select a version number as you're creating/editing a page? Or is there
> some other mechanism I'm not aware of for tagging that exists?
That seems the easiest question.
>
> Then my other question is, how do users continue to find "old" documentation?
> When I as an anonymous user go to node/######/revisions, I get an "Access
> Denied" error. Or will we have three handbooks, "Drupal 4.6," "Drupal 4.7," and
> "older stuff" (hope not, I could see all kinds of problems here)? Or will there
> be a block on the side that will provide links for people to switch between 4.7
> and 4.6 tagged documentation, if they exist?
The goal of the tagging is to provide users some information about
whether the current page applies to the version they are working with,
but does not provide a solution for maintaining separate handbook
versions. We don't seem to have a good solution at this time to your
questions about maintaining versions other than the fact that we can
provide a copy of the current handbook for archival purposes using the
printer-friendly feature, the docbook export function, and a pdf (when
djun has the time).
Certainly, something better would be good if someone can come up with a
solution and implement it. I would add that, IMHO, maintaining separate
handbook versions--i.e., working on a current and legacy version at the
same time--would seem highly impractical. The Drupal handbooks are
growing at an incredible rate. I personally don't be believe that we
have the resources to properly maintain a current, continually updated
version, much less manage a solution which would require keeping more
than one.
More information about the drupal-docs
mailing list