Re: [Freeipa-users] New login procedure for FreeIPA wiki - need advice!

[Petr Viktorin]

On 11/06/2013 03:33 PM, Alexander Bokovoy wrote:

On Wed, 06 Nov 2013, Pablo Carranza wrote:


Have you guys/gals considered using Sphinx ,
instead (perhaps, in conjunction with
ReadTheDocs.org
)?


Yes, we considered it.
Sphinx and ReadTheDocs are great for a library, but we're not really 
making a library. The tools we have now work well for us.


That said, if we wanted to document ipapython or ipaldap and make them 
available for projects other than IPA, I think Sphinx would be the tool 
to use.



I'm not sure how it helps -- we need a wiki working on FreeIPA org, it
is part of our development routine to work jointly on feature
development and we use wiki for that purpose -- see
http://www.freeipa.org/page/V3_Designs

We also have no need to use alternative hosting, current one is fine, so
github is not really a solution.



The developer docs, HOWTOs, release info, etc. are fine on the wiki.

IPA's end-user documentation is in Docbook/Publican, hosted at 
https://git.fedorahosted.org/git/docs/freeipa-guide.git -- once we make 
it presentable we'll host the built docs on freeipa.org as well.
(Of course it's a Git repo, anyone is free to make a mirror on Github. 
I'm sure you can find one :P)


--
Petr³

___
Freeipa-users mailing list
Freeipa-users@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-users

Re: [Freeipa-users] New login procedure for FreeIPA wiki - need advice!

[Alexander Bokovoy]

On Wed, 06 Nov 2013, Pablo Carranza wrote:


Have you guys/gals considered using Sphinx ,
instead (perhaps, in conjunction with ReadTheDocs.org
)?

I'm not sure how it helps -- we need a wiki working on FreeIPA org, it
is part of our development routine to work jointly on feature
development and we use wiki for that purpose -- see
http://www.freeipa.org/page/V3_Designs

We also have no need to use alternative hosting, current one is fine, so
github is not really a solution.

--
/ Alexander Bokovoy

___
Freeipa-users mailing list
Freeipa-users@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-users

Re: [Freeipa-users] New login procedure for FreeIPA wiki - need advice!

[Pablo Carranza]

Have you guys/gals considered using Sphinx ,
instead (perhaps, in conjunction with ReadTheDocs.org
)?

The documentation source can then be hosted on GitHub. For live examples,
check out:

   - Salt Cloud's Documentation;
   or


   - Gate One Documentation

-Pablo

vDevices.com  | Providing Hosted IT Solutions for
Lawyers & Other Mobile Professionals


On Wed, Nov 6, 2013 at 6:38 AM, Dmitri Pal  wrote:

> Hello,
>
> We are trying to make access to the FreeIPA wiki easier and allow
> contributions without addition overhead. In the past to make any change
> to wiki one had to have a special wiki account. The procedure of
> creating such account was cumbersome. We added support for OpenID. Among
> available providers we selected to support Fedora accounting system at
> least for now. OpenID configuration allows other providers like Google
> or Yahoo but we were concerned that trusting them might allow spam bots
> to connect and pollute the wiki. May be we are over cautious and we
> should open up to those providers? We are seeking advice from you on
> what is better.
> Right now it does not allow logins with old accounts any more, only with
> OpenID. Unfortunately it is all of nothing. But we do not want people
> that had accounts and were able to contribute in the past but do not
> have Fedora account to loose ability to contribute.
> Any ideas and suggestions welcome!
>
> --
> Thank you,
> Dmitri Pal
>
> Sr. Engineering Manager for IdM portfolio
> Red Hat Inc.
___
Freeipa-users mailing list
Freeipa-users@redhat.com
https://www.redhat.com/mailman/listinfo/freeipa-users