On Tue, Dec 14, 2021 at 7:17 AM Ben Cotton bcotton@redhat.com wrote:
On Thu, Dec 9, 2021 at 10:59 PM Ryan Lerch rlerch@redhat.com wrote:
- Archive this mailing list and move discussion for docs over to discussion.fedoraproject.org
I'd be okay with that. The more stuff that moves to Discussion, the less it throws me off when something isn't in my mail box. :-) But I'm also fine with keeping it as a mailing list if that works for the majority of contributors.
- Clean up all the docs repos, and move them to gitlab (specifically gitlab.com/fedora/docs) -- obviously this is a big and contentious one, but it would allow us to have subgroups for our tooling and docs, making it easier to group this stuff out. Also the way gitlab shows all tickets for groups will allow us to see issues across all our docs repos, rather than following many many repos.
Are you suggesting putting all of the docs in one repo? Because that idea makes me very sad from an ACL perspective.
No, more just about organizing and tidying the repos we have.
If you're talking about just putting the repos in a docs namespace, I can see the appeal, but IMO it's better to keep the docs close to the teams writing it. In fact, one of the things I've been meaning to push on the Council is combining the docs and tickets repos into one repo. Same for FESCo.
Definitely keeping the community docs where those subteams want them. But for the user documentation that the documentation team "owns" move this and organize it. (Maybe even document where the community docs come from too)
cheers, ryanlerch
There's probably some docs repo consolidation we can do, but *all* seems like too much without a better understanding of the benefits.
On Fri, Dec 10, 2021 at 11:00 AM Allan Day aday@redhat.com wrote:
As a newcomer to Fedora docs, I have definitely struggled to find the repo I'm looking for, though I can't say whether that's a result of lack of organisation, repo naming/descriptions, or simply the number of repos.
I tend to go to the docs I'm interested in and then click the "Edit this page" button to get the repo I want. It's not an ideal workflow, but it works.
-- Ben Cotton He / Him / His Fedora Program Manager Red Hat TZ=America/Indiana/Indianapolis _______________________________________________ docs mailing list -- docs@lists.fedoraproject.org To unsubscribe send an email to docs-leave@lists.fedoraproject.org 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/docs@lists.fedoraproject.org Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure