After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 724537 - Outdated documentation can confuse users: Put banner on non-recent versions; block indexing by search crawlers?
Outdated documentation can confuse users: Put banner on non-recent versions; ...
Status: RESOLVED OBSOLETE
Product: website
Classification: Infrastructure
Component: help.gnome.org
current
Other Linux
: Normal normal
: ---
Assigned To: GNOME Web maintainers
GNOME Web maintainers
Depends on:
Blocks:
 
 
Reported: 2014-02-17 13:14 UTC by Sebastian Keller
Modified: 2018-09-24 10:37 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Sebastian Keller 2014-02-17 13:14:30 UTC
Users often use google when looking for support and then might end up on outdated help pages hosted on help.gnome.org (or developer documentation on developer.gnome.org).
The documentation found this way is often outdated and doesn't apply anymore despite being hosted on gnome.org which makes it seem official and would lead users to assume it should be working.

An example I just witnessed on IRC:
Somebody was looking for a way to change the path where cheese stores its photos and found https://help.gnome.org/users/cheese/2.91/cheese.html#gconf which told him to use gconf-editor, which obviously doesn't work anymore with any recent version.

The only indication of why this would not be working is in the version number in the url, but this is not obvious.


Here are some ideas that could help with this problem:

- Add a banner to outdated documentation that it is for an unsupported version of the software

- Remove outdated documentation entirely (except for maybe the latest 3 stable releases and the latest unstable)

- use the robots.txt to prevent indexing of outdated versions (currently it only seems to prevent indexing of outdated stable versions, but still allows indexing of outdated unstable versions)


I think the banner would make the most sense and could be combined with the robots.txt.
Comment 1 GNOME Infrastructure Team 2018-09-24 10:37:45 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to GNOME's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.gnome.org/Infrastructure/Websites/issues/143.