search

OS2Forms / os2forms_docs

OS2Forms general documentation
1 stars 8 forks source link

📣 Calling All Contributors: Let’s form a dedicated maintainer team! #14

Open janhalen opened 3 weeks ago

janhalen commented 3 weeks ago

Proposal for allocation of ressources for a dedicated team for repository maintenance

This repository seems to be without a clear agreement on who acts as the maintainer team. I have observed stale PRs since 2021 and a pretty low activity rate.

To revitalize the repo, resources should be allocated to participate in and automate standard workflows like PR handling, issue triaging, and docs-as-code flows for documentation.

@Tgjerulff: Could this concern be raised with the steering and coordination committees?

@skifter, @lilosti: Could you please indicate if you are interested in submitting a bid for this task?

By investing up front in automation via GitHub Actions, the ongoing task is not a huge undertaking and the maintenance can be streamlined, enhance quality of docs and automation, thus boosting public community engagement.

TL;DR: The project needs allocated resources for setup and ongoing oversight. Any takers? 😃

skifter commented 3 weeks ago

@janhalen Are we talking about the os2forms_docs repo only ? :-)

janhalen commented 3 weeks ago

@janhalen Are we talking about the os2forms_docs repo only ? :-)

The scope for this issue is only the docs repo yes, but the steering or coordination committees can decide that a similar approach should be set in motion for more or even all repos. That would have to be broken down into other issues in the relevant repos...

skifter commented 3 weeks ago

Lets start with this one. Repos that are "important" are pinned in the top of the gitbub account. And should be the ones to look at. :-)

janhalen commented 3 weeks ago

Lets start with this one. Repos that are "important" are pinned in the top of the gitbub account. And should be the ones to look at. :-)

@skifter: Ok understood.. And the rest are due to be archived or consolidated/moved into other repos or organisations then? Or how do you view their state?

https://github.com/orgs/OS2Forms/repositories?q=sort%3Aupdated-asc

janhalen commented 2 weeks ago

A further suggestion for utilizing automation to limit the amount of manual maintenance work is to adapt a CODEOWNERS file in the relevant repos. https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.

Such a move will also deliver transparency benefits...

A sensible article describing what challenges a CODEOWNERs file can help tackle for the maintainers (@skifter, @ds-bellcom ) and what benefits the business side (@Tgjerulff ) can expect. ➡️ https://opensauced.pizza/blog/tech-knowledge-debt