Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1278460

Summary:	Add warning that FreeIPA guide is out of date
Product:	[Retired] Fedora Documentation	Reporter:	Petr Spacek <pspacek>
Component:	freeipa-guide	Assignee:	Pete Travis <me>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Fedora Docs QA <docs-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	devel	CC:	grundblom, me, mkosek
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2019-05-15 14:16:18 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

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!