#9892 Centralise and update Fedora infra and releng SOPs
Opened 3 months ago by mobrien. Modified 7 hours ago

Describe what you would like us to do:


We have a number of out of date SOPs which are distributed across different places. These should be updated and moved to a central place.

Once the SOP is put into the new central place the old one should have its content removed and a link to the new doc put in its place to avoid multiple copies.

When do you need this to be done by? (YYYY/MM/DD)


This will be a long running ticket, where hopefully a number of people can contribute


Metadata Update from @mohanboddu:
- Issue tagged with: medium-gain, medium-trouble, ops

3 months ago

A proposal for this is to have them on docs.fedoraproject.org under CPE. This would mean that infra and releng docs could be separate but grouped together under one umbrella.

This is only a suggestion so please voice opinions/concerns

21:12 <nb> mobrien so, I'm kind of -1 to putting all the docs under "CPE"
21:13 <nb> since CPE is just the Red Hat people. There are infra people who are not RH employees and thus not part of CPE

I would suggest making an infra section on docs.fedoraproject.org and moving everything there. I'm not sure how to handle the releng docs, if we want to put them there too, or create a separate releng section. Maybe make a "Infra+Releng" section on docs.fpo?

I would suggest making an infra section on docs.fedoraproject.org and moving everything there. I'm not sure how to handle the releng docs, if we want to put them there too, or create a separate releng section. Maybe make a "Infra+Releng" section on docs.fpo?

I like this idea too. It would benefit to have them together as there is crossover between the 2. If we were to have an Infra+Releng section then we could divide them under various sub headings.

Metadata Update from @kevin:
- Issue priority set to: Waiting on Assignee (was: Needs Review)

3 months ago

Is there a list of the current locations that house the SOPs in their current form?

I'm with Nick here - I don't like the idea of putting the docs under CPE namespace as Fedora Infrastructure team is not a subset of CPE.

Thanks for your input @mizdebsk and @nb a better idea may be to have an infrastructure and releng tile on the homepage of docs.fp.o and have them housed here. I will mail the infra list as well to get more coverage on this.

Is there a list of the current locations that house the SOPs in their current form?

@ryanlerch there is no official list as such but these are some of the places, note there is more than sops here but it does give an idea as to how spread out the docs are

https://fedora-infra-docs.readthedocs.io/en/latest/
https://pagure.io/Fedora-Infra/howtos/tree/main
https://docs.pagure.org/releng/
https://fedoraproject.org/wiki/Infrastructure

As well as some google docs scattered about

One approach here would be to have several repos (i.e. documents). For
example, we could break up this document:
https://fedora-infra-docs.readthedocs.io/en/latest/ into

  • Fedora Infra Developers Guide
  • Fedora Infra Sysadmin's Guide (i.e. the SOPs)

We would probably have to create a new section on this page:
https://docs.fedoraproject.org/en-US/docs/
There is an "Engineering Teams" section that contains a couple links
to our docs (https://docs.fedoraproject.org/en-US/engineering/)
but a whole separate category on the main page is probably a good idea
here IMHO.

This new section would probably list documents like the newish Fedora
Accounts document
(https://docs.fedoraproject.org/en-US/fedora-accounts/) and any other
user-facing documents about our apps too.

For the structure of the sources, something simple like repos labelled
"Documentation" in the fedora-infra github org might be the way to go,
like the source for the Fedora Accounts docs:
https://github.com/search?q=topic%3Adocumentation+org%3Afedora-infra&type=Repositories

Thanks for your input @mizdebsk and @nb a better idea may be to have an infrastructure and releng tile on the homepage of docs.fp.o and have them housed here. I will mail the infra list as well to get more coverage on this.

Is there a list of the current locations that house the SOPs in their current form?

@ryanlerch there is no official list as such but these are some of the places, note there is more than sops here but it does give an idea as to how spread out the docs are

https://fedora-infra-docs.readthedocs.io/en/latest/

AFAICT, https://docs.pagure.org/infra-docs/ is the same as this readthedocs, but is not rebuilt as regularly. Should we just decomission the RTD one now to avoid further confusion here (i was confused).

Would like to help @mobrien with this when he is back from PTO

Login to comment on this ticket.

Metadata
Boards 2
mini-initative Status: Backlog
ops Status: Backlog