[Freeipa-devel] Planning FreeIPA Upstream Doc changes: URL/docs.freeipa.org

[Martin Kosek]

On 08/08/2013 01:29 PM, Petr Spacek wrote:
> On 8.8.2013 09:19, Martin Kosek wrote:
>> - we can take advantage of publican and build a doc site like
>> "docs.freeipa.org" which would held publican-managed doc site with our guides.
> 
> I think that "docs" subdomain is very general and should point to some place
> with links to guide *and* how tos *and* presentations etc. Is it possible to do
> do something like that with Publican?

Should be. Look at docs.fedoraproject.org - also managed by Publican. I did a
first try here:
http://mkosek.fedorapeople.org/publican_site/ (just a PoC).

Alternatively, should the
> docs.freeipa.org site point to Documentation portal on wiki with some *huge*
> link to the guide?
> 
> What about guide.freeipa.org for the guide itself?
> 

IMO docs.freeipa.org is enough - it would contain all our guides (User Guide,
Extending FreeIPA guide, maybe also Web UI plugin developer guide...).

Martin