On 2 August 2017 at 21:34, Nick Coghlan <ncoghlan(a)gmail.com> wrote:
While working on
https://fedoraproject.org/wiki/User:Ncoghlan/Default_python_module, I
started getting annoyed at the lack of decent review and commenting
features in MediaWiki, so prompted by
https://docs.pagure.org/modularity/ I went ahead and started a
fedora-python repo at
https://pagure.io/fedora-python/fedora-python,
so we'll be able to use
https://docs.pagure.org/fedora-python/ as a
custom docs site.
I deliberately chose the Pagure group name to match the existing
GitHub one, but since my main intended use case is to review & discuss
Fedora design proposals before they make their way into the formal
Fedora change management processes, it seemed more appropriate to host
the repo on Fedora managed infrastructure.
Currently myself & Petr Viktorin are the only group members, but
that's just because I haven't added anyone else yet, not because I
expect the member list to actually stay that small.
Progress update here: the repo has some useful content!
It's a Sphinx project, currently being published here:
https://docs.pagure.org/fedora-python.fedora-python/
The relocated "default Python module" proposal is at
https://docs.pagure.org/fedora-python.fedora-python/default-python-module...
I'm not super fond of that auto-generated URL, nor do I like the
client-driven update process for pushing changes live, so I'm
wondering if ReadTheDocs might be a better option for publication,
rather than using Pagure's native static-site hosting.
Cheers,
Nick.
P.S. Now that I have the basic site up, I'd also like to switch to the
more Fedora-ish Sphinx theme used in the Modularity docs:
https://docs.pagure.org/modularity/docs.html
--
Nick Coghlan | ncoghlan(a)gmail.com | Brisbane, Australia