Orphaning FreeIPA guide

[Martin Kosek]

On 10/15/2014 04:03 PM, Jérôme Fenal wrote:
> 2014-10-15 13:01 GMT+02:00 Martin Kosek <mkosek at redhat.com>:
>> Hello all,
>>
>> FreeIPA project is already for some time without sufficient resources to revive
>> and maintain our former long upstream user guide. We did not find enough
>> manpower either in FreeIPA developer nor our users community, so we decided to
>> stop maintaining it.
>>
>> Detailed justification including links to mail threads in:
>> http://www.freeipa.org/page/Upstream_User_Guide
>>
>> I would like to avoid leaving any loose ends on Fedora Documentation project
>> side, do you have any recommendation for us? I already closed respective
>> Bugzillas and upstream Trac tickets with explanation. Should we also orphan the
>> guide in
>>
>> https://fedoraproject.org/wiki/Docs_Project_meetings#Guides
>>
>> or on any other locations? For starters, I think we should close the
>> "freeipa-guide" component of "Fedora Documentation" as nobody from our team
>> would be responding there.
> 
> Hi Martin,
> 
> What will happen to its downstream Linux Domain Identity Management
> Guide for RHEL?

Hello Jérôme,

RHEL guides as listed in
http://www.freeipa.org/page/Documentation#User_Guides
are still actively maintained by Red Hat Technical Writer(s) and should be up
to date. I added direct links to report any bugs that FreeIPA users may find.

> Should we rely solely on the product help for that documentation?

No. We want to focus on documentation in FreeIPA.org project community wiki,
i.e. design documents, (user) HOWTO articles or any other general articles that
our users or developers contribute to.

Wiki is generally much more easy to contribute due to easy syntax and narrow
focus of the pages. Maintaining whole user guide book in docbook is on a whole
different level of complexity and resource requirement on it's contributors -
thus the move from it upstream.

Martin