Links to gnome does are for "stable" instead of the correct version

[AJenbo]

Binary package hint: ubuntu-docs

scripts/fix-urls.sh changes changes the links to
http://library.gnome.org/users/user-guide/stable/panels.htm
to keep the documentation for the correct version as Gnome progress the links should be changed to
http://library.gnome.org/users/user-guide/2.32/panels.htm

[Connor Imes (ckimes)]

The site at http://library.gnome.org/users/user-guide/ does not show any other documentation except 2.32. Different versions of Ubuntu use different GNOME versions. Do you know if older documentation is kept online and where? A brief search did not find anything (e.g. for 2.28 which I think Lucid uses).

[AJenbo (ajenbo)]

Lucid uses 2.30

[Connor Imes (ckimes)]

Thanks for the correction, but do you know if docs for 2.30 (and other versions used in Ubuntu) are still online? If not, we'll stick with the stable ones. In the near future we may be pushing our own copy of the gnome-user-docs to help.ubuntu.com anyway since we are now using them for Unity documentation.

[Jeremy Bícha (jbicha)]

Connor, there is just http://library.gnome.org/users/user-guide/2.32/ which should be good enough for Lucid and just fine for Maverick.

[AJenbo (ajenbo)]

But will 2.32 stay online?

[Jeremy Bícha (jbicha)]

I fully expect for the 2.32 help to stay online for a while as most Gnome users are still using the 2.x series. Once most are using Gnome 3, they may pull the plug but I doubt that will happen this year.

[Connor Imes (ckimes)]

The problem is that the documentation needs to remain online for the life of the Ubuntu distro that has its help documentation linking to it. In this case, Lucid docs will be online until at least 2015 when the server support cycle ends. Other releases need to be online for at least 18 months, and given that the Gnome release precedes an Ubuntu release by at least a few months, the Gnome docs would have to be hosted for even longer. I think we are better off sticking with "stable" docs.

[Jeremy Bícha (jbicha)]

No, Lucid will only be supported until April 2013 on the Desktop which includes Yelp and the Gnome user docs. So that's 2 years and I think there's a reasonable chance that the docs will still be online then. Clearly the Gnome 3 docs do not at all describe Lucid's interface and so I recommend that this link be fixed and we can deal with the theoretical possibility of the link going dead if it were to actually happen.

[Connor Imes (ckimes)]

In the past we have kept all the docs online [1], not just the serverguide. I would not be opposed to taking the desktop help offline after EOL for the desktop version, it would just be a change in our current operating procedures.

[1] https://help.ubuntu.com/6.06/

I'd be more comfortable linking to the 2.x docs if we knew for a fact that they would remain online for the entire length of time we need them. It would be a pretty serious problem if all the Gnome links suddenly went dead from our pages on help.ubuntu.com. We can always put in a request upstream with Gnome to ask if they would host older docs.

Otherwise, we should host them ourselves as I mentioned in post #3, which I think is the actually the best way forward.

[AJenbo (ajenbo)]

Agreed

[Launchpad Janitor (janitor)]

[Expired for ubuntu-docs (Ubuntu) because there has been no activity for 60 days.]

[Jeremy Bícha (jbicha)]

This is fixed for Ubuntu 11.10 and later as we point to the docs for the appropriate GNOME release, i.e. we point to the Brasero 3.6 docs for Ubuntu 12.10 but 3.4 for Ubuntu 12.04 LTS.

I don't really have the time to care about Ubuntu 10.04 LTS docs at this point (it only has 6 more months of support anyway).