#9892 Centralise and update Fedora infra and releng SOPs
Opened 24 days ago by mobrien. Modified 10 days 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

24 days 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)

23 days 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

Login to comment on this ticket.

Metadata
Boards 1
ops Status: Backlog