File: maintainer-guide.rst

package info (click to toggle)
modules 5.6.1-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 23,036 kB
  • sloc: exp: 79,659; sh: 6,142; tcl: 5,900; makefile: 1,493; ansic: 474; python: 265; csh: 202; perl: 47; ruby: 44; lisp: 13
file content (76 lines) | stat: -rw-r--r-- 2,343 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
.. _maintainer-guide:

Maintainer guide
================

Maintainers ensure that the project remains reliable, sustainable, and aligned
with :ref:`its mission<CHARTER>`. Maintainers oversee contributions, manage
releases, guide contributors, and uphold project standards.

Maintainers are stewards of both the code-base and the community. Strive to
balance technical excellence with empathy and collaboration. Core
responsibilities are described below.

Code stewardship
----------------

* Review and merge pull requests (PRs) carefully and fairly.
* Ensure that all code follows project **coding standards**, **testing**, and
  **documentation** requirements.
* Keep the main branch in a **buildable and releasable** state.
* Maintain compatibility across supported platforms (e.g., Linux, macOS, BSDs,
  Windows).

Community management
--------------------

* Engage respectfully with users and contributors via:

  - GitHub issues and pull requests
  - Mailing list and chat
  - HPC community events

* Mentor new contributors and ensure a welcoming, inclusive culture.
* Enforce and model the project’s `Code of conduct`_.

.. _Code of conduct: https://github.com/envmodules/modules?tab=coc-ov-file#readme

Issue and pull request triage
-----------------------------

* Label issues appropriately (``bug``, ``enhancement``, ``question``, etc.).
* Review pull requests for:

  - Completeness (tests, docs)
  - Coding style and maintainability
  - Reproducibility of reported issues

* Merge (rebase merging) once review and CI checks are passed.

Documentation & communication
-----------------------------

* Keep user and developer documentation up to date.
* Maintain consistency between ``README``, ``INSTALL``, and manual pages.
* Communicate major changes through release notes, mailing list, chat and
  social media.

Infrastructure & tooling
------------------------

* Maintain CI pipelines and automated test coverage.
* Manage GitHub Actions, Cirrus, test scripts, and build tools.
* Ensure reproducibility and backward compatibility across builds.

Reference materials
-------------------

* :ref:`CHARTER`
* :ref:`GOVERNANCE`
* :ref:`CONTRIBUTING`
* :ref:`create-new-release`
* `Security policy`_

.. _Security policy: https://github.com/envmodules/modules/security

.. vim:set tabstop=2 shiftwidth=2 expandtab autoindent: