On Tue, May 04, 2021 at 04:49:43PM +0100, Mark O'Brien wrote:
Hi All,
As some of you may be aware there has been chatter around having the
documentation for infrastructure and release engineering centralised in one
place.
A possible solution to this is to move all of these under a new section on
docs.fedoraproject.org called something like Infrastructure and Release
Engineering (very original I know).
Sounds good to me. :)
We could then go about moving docs which are suitable from currrent
locations to the new central point. Each doc should be updated before
moving and the old document should be updated to only contain a link to the
new doc to avoid a case of multiple versions of a doc (
https://xkcd.com/927/
).
The following links contain the bulk of the documentation:
https://fedora-infra-docs.readthedocs.io/en/latest/
https://docs.pagure.org/releng/
https://fedoraproject.org/wiki/Infrastructure
These would be the suggested first steps with other docs to follow if/when
these are completed.
As I say this is just a possible solution so as always all feedback and
suggestions are encouraged and welcomed.
I think it's a good idea to centralize them like this.
Some things are kind of hazy if they are Infrastructure or Release
engineering, but otherwise I think the two areas could go well together.
Probibly the first thing we should do is work on moving and reworking
the contribution/getting started stuff out of the wiki and into docs. :)
Then, perhaps it might make sense to do a pass and mark/note all the
docs we want to just drop (no longer relevent, etc).
Thanks for working on this!
kevin