Re: Infrastructure and release engineering Documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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

Attachment: signature.asc
Description: PGP signature

_______________________________________________
infrastructure mailing list -- infrastructure@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to infrastructure-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/infrastructure@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure

[Index of Archives]     [Fedora Development]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Yosemite News]     [KDE Users]

  Powered by Linux