[Bug 1278460] New: Add warning that FreeIPA guide is out of date

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1278460

Bug ID: 1278460
           Summary: Add warning that FreeIPA guide is out of date
           Product: Fedora Documentation
           Version: devel
         Component: freeipa-guide
          Assignee: [e-mail]
          Reporter: [e-mail]
        QA Contact: [e-mail]
                CC: [e-mail]

Description of problem:
Docs related to FreeIPA like
https://docs.fedoraproject.org/en-US/Fedora/15/html/FreeIPA_Guide/Using_Micr...
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!

[Bug 1278460] Add warning that FreeIPA guide is out of date

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1278460

Pete Travis  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |ASSIGNED

--- Comment #1 from Pete Travis  ---
Hey Petr, we'll see what we can do for you.

[Bug 1278460] Add warning that FreeIPA guide is out of date

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1278460

Glen Rundblom  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |[e-mail]

--- Comment #2 from Glen Rundblom  ---
Hi Pete, I think I can do this. May I work on this?
Thanks,
-Glen

[Bug 1278460] Add warning that FreeIPA guide is out of date

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1278460

--- Comment #3 from Martin Kosek  ---
It would also make sense to reference

http://www.freeipa.org/page/Upstream_User_Guide

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).

[Bug 1278460] Add warning that FreeIPA guide is out of date

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1278460

--- Comment #4 from Martin Kosek  ---
My related proposal for Fedora documentation:

https://lists.fedoraproject.org/archives/list/[e-mail]/t...

[Bug 1278460] Add warning that FreeIPA guide is out of date

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1278460

Pete Travis  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|ASSIGNED                    |MODIFIED

--- Comment #5 from Pete Travis  ---
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.

[Bug 1278460] Add warning that FreeIPA guide is out of date

[Red Hat Bugzilla]

https://bugzilla.redhat.com/show_bug.cgi?id=1278460

--- Comment #6 from Martin Kosek  ---
The redirect is now effective and works. Thank you!