Upstream_User_Guide#
Currently, FreeIPA project does not actively maintain any upstream guide in a form of a book. The upstream authoritative source of information is the this wiki site. Please see Documentation page for the list of the most recent user documentation and links to books written by others.
Contribute#
We are looking forward to contributions from the FreeIPA community! Please see page Contribute/Documentation for further information.
History#
Until 2013, FreeIPA project had a Technical Writer maintaining both RHEL downstream guide and upstream FreeIPA guide built for Fedora project. When the Technical Writer got out of capacity to handle the upstream guide, the FreeIPA development team announced an effort to carry the torch and forked the outdated documentation in a new repository and started the work on reviving it again (Trac milestone 1, Trac milestone 2).
Unfortunately, over it became apparent that despite several brave contributors helping with the guide, the project simply does not have resources to develop both FreeIPA and comprehensive documentation for it. The FreeIPA guide was way behind the RHEL downstream guides maintained by a new Technical Writer. In addition, old Fedora released documentation often popped up and clobbered FreeIPA upstream documentation in search engine results. The situation required change that FreeIPA users are not confused with obsolete information.
Writing documentation is enormous task in itself. However, until a team of upstream Technical Writers joins the project to contribute alongside the developers (call for help on freeipa-users list) the only viable option is to stop maintaining and reviving the upstream guide and keep only 2 main sources of documentation - design documents and articles of this community wiki, and downstream documentation, from which the RHEL one is the most complete. Guide was orphaned, as announced on fedora-docs list.
Deprecated Upstream Guides#
The following upstream guides are deprecated and no longer maintained:
Upstream FreeIPA 1.2.1 Installation and Deployment Guide (previously hosted on
www.freeipa.org/docs/1.2/Installation_Deployment_Guide/en-US/html/index.html)Upstream FreeIPA 2.0 Installation and Deployment Guide (previously hosted on
www.freeipa.org/docs/2.0.0/Installation_Deployment_Guide/en-US/html/index.html)Fedora FreeIPA 2.2.0 Guide for F17 (redirected to this wiki from August 2016)
Fedora FreeIPA 2.1.3 Guide for F15 (redirected to this wiki from August 2016)
Fedora FreeIPA 3.1.5 Guide for F18 (redirected to this wiki from August 2016)
WIP upstream guide generated from the forked upstream docs repository