Add notes from May #80
Conversation
| * We're using a personal account (Mariatta's). Not ideal. Right now community version of RtD doesn't support multiple owners, there are workarounds. Organizations are only in the commercial version so far. | ||
| * would be nice to have an ORG account. |
There was a problem hiding this comment.
Read the Docs Community does not support organizations yet. However, it does support multiple maintainers with admin permissions for the same project. As a example, this is how we have configured our own documentation:
There was a problem hiding this comment.
Right, thanks, and I believe we use that on our main RTD-hosted/previewed stuff, with at least three-ish people added there for each. If I understand the concern here, though, it is that each project is still technically "owned" by one individual person's personal account, leading to an eventual single point of failure, alongside the inability to centrally manage many different projects with different owners/maintainers owned by one FOSS entity, its all scattered between individual people's accounts.
This because particularly problematic if we end up moving the hosting of the Python docs to RTD, since it means the ultimate responsibility for a docs site that gets tens of millions of hits per month would have to rest on the shoulders of one person.
There was a problem hiding this comment.
Sure, it would be nice for central management and an org account.
But practically, I'm not too worried about that. The main thing is to make sure enough have admin access to keep the bus factor healthy.
Currently it's just Mariatta and me for the CPython previews. Would any other core devs like access too?
There was a problem hiding this comment.
Not a core dev, but for consistency purposes you could add Ee. And if you need an extra person and don't have someone better, you could add me if needed—I'm not actually an admin of any other RTD-hosted project right now, so it would be helpful to have at least one I can get familiar with.
There was a problem hiding this comment.
@CAM-Gerlach Please create an RtD account, lete know the username, and I'll add you!
There was a problem hiding this comment.
@hugovk Actually seems like I do have a RTD account, under the username CAM-Gerlach, in case you want to add that.
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
|
I see @hugovk 's checkmark is gray but mine is green (indicating I have write access but he doesn't)_, despite the fact that he's been one of the most active core devs helping out on docs infra lately. Can he be added to whatever team(s) give him that? |
|
The people with write access is those in the docs-triagers team. |
|
I've added core devs. |
📚 Documentation preview 📚: https://docs-community--80.org.readthedocs.build/en/80/