[Freeipa-users] FreeIPA 3.1.5 User Guide published!

[Petr Spacek]

On 26.6.2013 08:15, Martin Kosek wrote:
> On 06/25/2013 10:58 PM, Dean Hunter wrote:
>> On Tue, 2013-06-25 at 18:07 +0200, Martin Kosek wrote:
>>> Hello,
>>>
>>> The FreeIPA Team has published a User Guide for FreeIPA 3.1.x series
>>> introduced
>>> in Fedora 18:
>>>
>>> http://docs.fedoraproject.org/en-US/Fedora/18/html/FreeIPA_Guide/index.html
>>>
>>> Big thanks to Deon Lackey who was the main contributor for this docs!
>>>
>>> On a side note, FreeIPA team is in process of re-considering and improving our
>>> user/development documentation and I am just curious - are FreeIPA users well
>>> aware of this documentation, do you use it frequently when you seek FreeIPA
>>> related information? Any ideas for improvements?
>>>
>>> Do you want to continue us to release this guide frequently with FreeIPA
>>> releases? For sake of future, we are also considering releasing this User
>>> Guide
>>> right during FreeIPA release, in a special subpackage (e.g. freeipa-docs).
>>>
>>> Thanks for any feedback.
>>>
>> I am also a big fan of up-to-date documentation.  I make it a priority to
>> research as much as I can before I start into something new.  Unfortunately, I
>> do not always understand everything I read.  And somethimes what I read is no
>> longer accurate as I noted a couple of days ago regarding section 14.4 of this
>> document.
>
> Can you please file an upstream ticket using "documentation" component when
> you find sections which are no longer accurate or which you would like to
> improve?
>
> https://fedorahosted.org/freeipa/newticket
>
> Having it noted somewhere helps us with tracking the deficiency and having
> enough data to fix it.

We could add "Report a bug/ambiguity" links to the docs. This could encourage 
people to report which parts of docs are not clear enough etc.

https://fedorahosted.org/freeipa/ticket/3754

-- 
Petr^2 Spacek