GNOME Bugzilla – Bug 724537
Outdated documentation can confuse users: Put banner on non-recent versions; block indexing by search crawlers?
Last modified: 2018-09-24 10:37:45 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.
-- 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.