Jump to: navigation, search

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.

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.

Call for contributors

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.

Current state

The following upstream guides are deprecated and no longer maintained:

See Documentation page for the list of the active downstream maintained guides and other documentation sources!