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.
I also haven't actually *done* anything with the repo yet, but after PyCon Australia this weekend I'll look at moving my draft design doc for a default Python module over there, and potentially turning that doc into a general design proposal for how we want to handle the Python modules for the F27 Modular Server in general (aside from the "default-python" module idea, I expect most of that will just be writing down folks existing plans in a single place though)
Cheers, Nick.
P.S. https://fedoraproject.org/wiki/FinalizingFedoraSwitchtoPython3 could potentially move over to the new repo as well, allowing folks to submit suggested amendments as PRs
On 2 August 2017 at 21:34, Nick Coghlan ncoghlan@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.ht...
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
On 11 August 2017 at 17:34, Nick Coghlan ncoghlan@gmail.com wrote:
The relocated "default Python module" proposal is at https://docs.pagure.org/fedora-python.fedora-python/default-python-module.ht...
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.
After updating the theme to be more Fedora-ish (i.e. I took the Fedora Modularity theme and removed the bits I didn't need), I ran into a problem where the Pagure-hosted docs weren't rendering the Fedora Loves Python logo correctly, even though that worked fine when browsing the built docs locally, and even though choosing "View Image" from the Firefox context menu took you to the correct SVG file.
So I decided to set up a build on ReadTheDocs instead, and that looks to have just worked, including the logo rendering: https://fedora-python.readthedocs.io/en/latest/
Since RTD's webhook support also solves the autobuild-on-commit problem, I'm thinking that may be the better way to go (I'll just need some other folks RTD usernames so I can add you as co-maintainers to the project)
Cheers, Nick.
On 15 August 2017 at 19:44, Nick Coghlan ncoghlan@gmail.com wrote:
So I decided to set up a build on ReadTheDocs instead, and that looks to have just worked, including the logo rendering: https://fedora-python.readthedocs.io/en/latest/
I couldn't get Pagure's webhooks to work properly (see https://pagure.io/pagure/issue/2522), so revising the revised plan: could someone with the appropriate access create me a fedora-python repo under https://github.com/fedora-python and grant me admin access to it? :)
With the Pagure folks being busy with the dist-git integration, that makes more sense to me than fiddling about trying to get Pagure's webhooks working.
Cheers, Nick.
On 08/18/2017 12:06 PM, Nick Coghlan wrote:
On 15 August 2017 at 19:44, Nick Coghlan ncoghlan@gmail.com wrote:
So I decided to set up a build on ReadTheDocs instead, and that looks to have just worked, including the logo rendering: https://fedora-python.readthedocs.io/en/latest/
I couldn't get Pagure's webhooks to work properly (see https://pagure.io/pagure/issue/2522), so revising the revised plan: could someone with the appropriate access create me a fedora-python repo under https://github.com/fedora-python and grant me admin access to it? :)
Sure. Added you; you should be getting notifications about this.
On 21 August 2017 at 19:53, Petr Viktorin pviktori@redhat.com wrote:
On 08/18/2017 12:06 PM, Nick Coghlan wrote:
I couldn't get Pagure's webhooks to work properly (see https://pagure.io/pagure/issue/2522), so revising the revised plan: could someone with the appropriate access create me a fedora-python repo under https://github.com/fedora-python and grant me admin access to it? :)
Sure. Added you; you should be getting notifications about this.
Thanks! Repo updated: https://github.com/fedora-python/fedora-python
If you let me know your ReadTheDocs username, I'll add you to the maintainer list for that as well.
Cheers, Nick.
python-devel@lists.fedoraproject.org
-
Nick Coghlan -
Petr Viktorin