FreeIPA ReadTheDocs site

[Alexander Bokovoy]

Hi,

Thanks to Christian Heimes' work, we now have auto-generated FreeIPA
documentation at https://freeipa.readthedocs.io/en/latest/. It currently
only includes in-tree design documents and FreeIPA workshop but more to
come as older design pages and HOW TOs get converted to upstream git
tree.

If anyone wants to help with the conversion, please don't hesitate to
contact me or Christian.



-- 
/ Alexander Bokovoy
Sr. Principal Software Engineer
Security / Identity Management Engineering
Red Hat Limited, Finland

[Dirk Streubel]

Hello Alexander,

is there i could do in my "downtime" let me know.

Regards

Dirk



Am 21.03.20 um 07:30 schrieb Alexander Bokovoy via FreeIPA-users:
> Hi,
>
> Thanks to Christian Heimes' work, we now have auto-generated FreeIPA
> documentation at https://freeipa.readthedocs.io/en/latest/. It currently
> only includes in-tree design documents and FreeIPA workshop but more to
> come as older design pages and HOW TOs get converted to upstream git
> tree.
>
> If anyone wants to help with the conversion, please don't hesitate to
> contact me or Christian.
>
>
>

[Alexander Bokovoy]

Hi Dirk,

On ma, 23 maalis 2020, Dirk Streubel via FreeIPA-users wrote:
> Hello Alexander,
>
> is there i could do in my "downtime" let me know. 
Thanks for volunteering! ;)

We have a bunch of design pages in
https://www.freeipa.org/page/V4_Designs It would be nice to convert them
to markdown/re-structured and submit as pull requests upstream. I would
recomment reading through https://gist.github.com/dupuy/1855764 for
details on how to make reST/markdown compatible markup.

See, for example, https://github.com/freeipa/freeipa/pull/3825 that is
purely adding a design page (this one is a new design but it has no
code, just the text added). Along with the design page, a change is needed
to doc/designs/index.rst to reference that page, similar to other pages.

Please see https://www.freeipa.org/page/Contribute/Code for details on
how to contribute changes via pull requests.

Thank you in advance!

> Regards
>
> Dirk
>
>
>
> Am 21.03.20 um 07:30 schrieb Alexander Bokovoy via FreeIPA-users:
> > Hi,
> >
> > Thanks to Christian Heimes' work, we now have auto-generated FreeIPA
> > documentation at https://freeipa.readthedocs.io/en/latest/. It currently
> > only includes in-tree design documents and FreeIPA workshop but more to
> > come as older design pages and HOW TOs get converted to upstream git
> > tree.
> >
> > If anyone wants to help with the conversion, please don't hesitate to
> > contact me or Christian.
> >
> >
> >
> _______________________________________________
> FreeIPA-users mailing list -- freeipa-users(a)lists.fedorahosted.org
> To unsubscribe send an email to freeipa-users-leave(a)lists.fedorahosted.org
> Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
> List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
> List Archives:
> https://lists.fedorahosted.org/archives/list/[e-mail]... 


-- 
/ Alexander Bokovoy
Sr. Principal Software Engineer
Security / Identity Management Engineering
Red Hat Limited, Finland