Bug 1278460 - Add warning that FreeIPA guide is out of date
Summary: Add warning that FreeIPA guide is out of date
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Fedora Documentation
Classification: Fedora
Component: freeipa-guide
Version: devel
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Pete Travis
QA Contact: Fedora Docs QA
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-11-05 14:36 UTC by Petr Spacek
Modified: 2019-05-15 14:16 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-05-15 14:16:18 UTC
Embargoed:


Attachments (Terms of Use)

Description Petr Spacek 2015-11-05 14:36:04 UTC
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!

Comment 1 Pete Travis 2015-11-05 14:38:18 UTC
Hey Petr, we'll see what we can do for you.

Comment 2 Glen Rundblom 2015-11-11 18:12:48 UTC
Hi Pete, I think I can do this. May I work on this?
Thanks,
-Glen

Comment 3 Martin Kosek 2015-11-13 12:55:53 UTC
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).

Comment 4 Martin Kosek 2016-07-01 08:41:38 UTC
My related proposal for Fedora documentation:

https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org/thread/6RQVAM6YNCCL75X4PIM3XM4R6R4WT2YR/

Comment 5 Pete Travis 2016-08-05 02:19:51 UTC
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.

Comment 6 Martin Kosek 2016-08-11 06:48:54 UTC
The redirect is now effective and works. Thank you!


Note You need to log in before you can comment on or make changes to this bug.