bioperl-live icon indicating copy to clipboard operation
bioperl-live copied to clipboard

Suggestion: create a CODEOWNERS file to connect modules with maintainers

Open zmughal opened this issue 1 year ago • 2 comments

Some examples:

This helps with automatically assigning to issues and PRs. Possibly starting with the listing from git grep "Cared for".

zmughal avatar Apr 19 '23 17:04 zmughal

Beware with the use of the word "owner". We are already using it to mean the people that own/hold the copyright for individual files. This is encoded as comments in the individual files as # OWNER: ... e.g.:

https://github.com/bioperl/Bio-Tools-Phylo-PAML/blob/5658f0d3ce92c418f444a1112b2c85ad67ca2069/lib/Bio/Tools/Run/Phylo/PAML/Evolver.pm#L20

https://github.com/bioperl/Bio-Tools-Phylo-PAML/blob/5658f0d3ce92c418f444a1112b2c85ad67ca2069/bin/bp_pairwise_kaks#L20

https://github.com/bioperl/Bio-Tools-Run-Alignment-TCoffee/blob/726458dc1bb5cd28dd41c2aaa2ef3cbc68f5dc57/lib/Bio/Tools/Run/Alignment/TCoffee.pm#L26

These comments are then used to generate the POD documentation (when available).

Maybe something like "Maintainer" would be better. Also, maybe also put it on the individual files, next to the owner and author blocks?

carandraug avatar Apr 20 '23 20:04 carandraug

Yes, the CODEOWNERS file is more about automating the process of maintenance. Only a suggestion if it helps with triaging. It could even be generated automatically (via dzil) from the source if that kind of # MAINTAINER: line is added to individual files.

zmughal avatar Apr 26 '23 18:04 zmughal