Red Hat Bugzilla – Bug 1278460
Add warning that FreeIPA guide is out of date
Last modified: 2016-08-11 02:48:54 EDT
Description of problem:
Docs related to FreeIPA like https://docs.fedoraproject.org/en-US/Fedora/15/html/FreeIPA_Guide/Using_Microsoft_Windows.html are quite old and outdated. This makes our life hard because Google is offering these old docs all the time and people are trying to use it, despite the fact that it is outdated.
Please add BIG FAT warning on top of each page in the guide and say 'This is outdated, go and read http://www.freeipa.org/page/Documentation instead!'
I imagine something like Warning box on top of each page before any other text. I have no idea if it is possible or not.
Thank you for your time!
Hey Petr, we'll see what we can do for you.
Hi Pete, I think I can do this. May I work on this?
It would also make sense to reference
which explains the history with user guide and specifies which guides are deprecated (all of them, except FreeIPA.org wiki and Red Hat supported docs).
My related proposal for Fedora documentation:
Hi Petr and Martin, I've just set up a robots.txt directing all crawlers to ignore the IPA guides at docs.fp.o, and added a RewriteRule on the site to https://www.freeipa.org/page/Documentation . Actually unpublishing those guides has proven a technical challenge; it may be more immediately achievable and appropriate to replace them entirely with a derivation of http://www.freeipa.org/page/Upstream_User_Guide - or simply leave the redirect in place.
The redirect is now effective and works. Thank you!