<div dir="ltr">I'm also a big fan of the documentation and reference it frequently. <div><br></div><div style>I know that documentation is not release notes, but it would be nice to have some relation between the two. Two ideas:</div>
<div style>* If the docs are released at the same time as the software, the release notes should include links to the relevant sections of the documentation.</div><div style>* For particularly large features, it may make sense to put a *temporary* note that feature X is new in version Y (and the note would be removed in Z or Z+1).</div>
<div style><br></div><div style>The second idea is taken from Python's documentation and how they do an excellent job of specifying when certain features were added. Now, FreeIPA doesn't have near the varying number of versions and legacy environments that a programming language has. That's why I wouldn't want tags like "added in 2.1.0" still hanging around.</div>
<div style><br></div><div style>Lastly, the documentation needs some release notes of it's own. The document change history isn't that useful. Two ideas:</div><div style>* A better "what's new in the docs" page that specifically links to new sections.</div>
<div style>* Asterisks or some other markup on the table of contents that mark links that have substantively changed.</div><div style><br></div><div style>A user browsing the table of contents may become interested in checking out a new feature since she knows that the typical high-quality FreeIPA documentation is right there to help.</div>
<div style><br></div><div style>How would the freeipa-docs package work? PDFs in a directory or would they be accessible from my FreeIPA web interface? I would definitely be interested in the package if its the later. Otherwise, I'll probably stick to the Fedora Docs website.</div>
<div style><br></div><div style>Excellent work. Thanks Deon and company. </div><div style><br></div><div style>Lastly, Fedora 19 is nigh upon us. Time to dive right back into the fire.</div><div style><br></div><div style>
Cheers, </div><div style>Justin</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Jun 25, 2013 at 2:10 PM, Andrew Tranquada <span dir="ltr"><<a href="mailto:andrew.tranquada@mailtrust.com" target="_blank">andrew.tranquada@mailtrust.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I am aware of the documentation and have found it invaluable so far, one<br>
of the better documented projects out there.<br>
Personally, I would love this guide released frequently and  really like<br>
the idea of having the documentation in a sub package.<br>
<br>
Thanks!!!<br>
<div class="HOEnZb"><div class="h5"><br>
<br>
<br>
<br>
<br>
<br>
On 6/25/13 12:07 PM, "Martin Kosek" <<a href="mailto:mkosek@redhat.com">mkosek@redhat.com</a>> wrote:<br>
<br>
>Hello,<br>
><br>
>The FreeIPA Team has published a User Guide for FreeIPA 3.1.x series<br>
>introduced<br>
>in Fedora 18:<br>
><br>
><a href="http://docs.fedoraproject.org/en-US/Fedora/18/html/FreeIPA_Guide/index.htm" target="_blank">http://docs.fedoraproject.org/en-US/Fedora/18/html/FreeIPA_Guide/index.htm</a><br>
>l<br>
><br>
>Big thanks to Deon Lackey who was the main contributor for this docs!<br>
><br>
>On a side note, FreeIPA team is in process of re-considering and<br>
>improving our<br>
>user/development documentation and I am just curious - are FreeIPA users<br>
>well<br>
>aware of this documentation, do you use it frequently when you seek<br>
>FreeIPA<br>
>related information? Any ideas for improvements?<br>
><br>
>Do you want to continue us to release this guide frequently with FreeIPA<br>
>releases? For sake of future, we are also considering releasing this User<br>
>Guide<br>
>right during FreeIPA release, in a special subpackage (e.g. freeipa-docs).<br>
><br>
>Thanks for any feedback.<br>
><br>
>--<br>
>Martin Kosek <<a href="mailto:mkosek@redhat.com">mkosek@redhat.com</a>><br>
>Supervisor, Software Engineering - Identity Management Team<br>
>Red Hat Inc.<br>
><br>
>_______________________________________________<br>
>Freeipa-users mailing list<br>
><a href="mailto:Freeipa-users@redhat.com">Freeipa-users@redhat.com</a><br>
><a href="https://www.redhat.com/mailman/listinfo/freeipa-users" target="_blank">https://www.redhat.com/mailman/listinfo/freeipa-users</a><br>
<br>
<br>
_______________________________________________<br>
Freeipa-users mailing list<br>
<a href="mailto:Freeipa-users@redhat.com">Freeipa-users@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/freeipa-users" target="_blank">https://www.redhat.com/mailman/listinfo/freeipa-users</a><br>
</div></div></blockquote></div><br></div>