You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/source/developing/infrastructure.rst
+5-6Lines changed: 5 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,7 +54,7 @@ ReadTheDocs
54
54
-----------
55
55
56
56
The Sphinx documentation is hosted by `ReadTheDocs
57
-
<https://readthedocs.org/>`__. Rich controls the account (and Rob has access to it). This is
57
+
<https://readthedocs.org/>`__. Rich controls the account (and Rob and Evan have access to it). This is
58
58
currently free for open source software.
59
59
60
60
@@ -68,11 +68,10 @@ service.
68
68
Website
69
69
^^^^^^^
70
70
71
-
We still use the mesa.sourceforge.net website domian name.
72
-
The source code for this site lives at https://github.com/MESAHub/mesa-website.
73
-
It must be manually updated by someone with SourceForge permissions.
71
+
We still use the mesa.sourceforge.net website domian name, but only for a top-level
72
+
redirect to docs.mesastar.org.
74
73
75
-
This site will be made redundant soon and replaced with a redirect to the ReadTheDocs website.
74
+
The source code for the old sourceforge site lives at https://github.com/MESAHub/mesa-website.
76
75
77
76
Slack
78
77
-----
@@ -115,6 +114,6 @@ is controlled by Pablo.
115
114
Records
116
115
^^^^^^^
117
116
118
-
* The `record for MESA releases <https://zenodo.org/record/4311514>`__ is controlled by Josiah.
117
+
* The `record for MESA releases <https://zenodo.org/record/4311514>`__ is controlled by Pablo.
119
118
* The `record for OP Mono data <https://zenodo.org/record/4390522>`__ is controlled by Josiah.
120
119
* The records for MESA SDK releases (`macOS <https://zenodo.org/record/4638654>`__, `linux <https://zenodo.org/record/4638535>`__) are controlled by Pablo.
Copy file name to clipboardExpand all lines: docs/source/developing/new_developers.rst
+17-18Lines changed: 17 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ New developers
9
9
What is a developer?
10
10
--------------------
11
11
12
-
A developer is someone who commits to spend (some) time helping to run and maintain the MESA project. This can include adding new code and documentation but also includes many other tasks that are needed to keep the project running. These include (but not limited to) managing and maintaining infrastructure, running meetings, triaging bug reports, merging Pull Requests, applying for funding for infrastructure, and providing technical and scientific knowledge to other developers. The amount of time someone commits is up to the individual to decide on, and it is expected to vary over time as various other tasks take priority.
12
+
A developer is someone who commits to spend (some) time helping to run and maintain the MESA project. This can include adding new code and documentation but also includes many other tasks that are needed to keep the project running. These include (but are not limited to) managing and maintaining infrastructure, running meetings, triaging bug reports, merging Pull Requests, applying for funding for infrastructure, and providing technical and scientific knowledge to other developers. The amount of time someone commits is up to the individual to decide on, and it is expected to vary over time as various other tasks take priority.
13
13
14
14
If you simply want to fix a bug or get some new code added to MESA then you don't need to be a developer. We welcome PR's and bug reports from the community and you don't need to be a developer to contribute that way. Only if you want to take a more active role in managing the MESA project do you need to be a developer.
15
15
@@ -33,50 +33,49 @@ Process:
33
33
* To veto someone then either:
34
34
35
35
* Two separate people should raise objections on their own in either slack or mesa-dev.
36
-
* Or, one person raises an objection and for privacy reasons they do not want to share this with the entire developer group. In which case they should discuss with another developer, who they trust, and that person can raise the second veto. In this case objections should be communicated to the nominator directly, but the objector does not have to share their reasons.
36
+
* Or, one person raises an objection and for privacy reasons they do not want to share this with the entire developer group. In this case, they should discuss with another developer, whom they trust, and that person can raise the second veto. In this case objections should be communicated to the nominator directly, but the objector does not have to share their reasons.
37
37
38
-
If after the minimum time has elapsed there are insufficient objections then the new developer is approved.
38
+
If after the minimum time has elapsed there are insufficient objections, then the new developer is approved.
39
39
40
40
.. note::
41
41
With this process we are attempting to balance having a flexible procedure for bringing in new developers while providing an environment that all developers can work safely in. There may be reasons why someone does not want to share the reasons for vetoing someone. However we also want to balance the possibility for abuse of the system by allowing arbitrary vetoes, which may preclude people from certain groups. We are adopting this process through the calendar year 2023, and plan to evaluate and vote on whether to make it permanent at the beginning of 2024.
42
42
43
-
Post acceptance
43
+
Post Acceptance
44
44
---------------
45
45
46
-
Assuming the new developer has been accepted then the nominator:
46
+
Assuming the new developer has been accepted, the nominator:
47
47
48
48
* Makes sure the new developer agrees to the code of conduct and knows that discussions on dev channels should be considered private and may include work in progress and thus should not be shared.
49
-
* Makes sure the new developer gets access to the infrastructure (github, slack, mesa-dev, testhub)
49
+
* Makes sure the new developer gets access to the infrastructure (github, slack, mesa-dev, testhub).
50
50
* Acts as a mentor to the new developer, helping them to get used to the system and the way things are done. This includes making commits, merging PR's, and general development tasks.
51
51
52
-
Removing a developer
52
+
Removing a Developer
53
53
--------------------
54
54
55
55
At any time an existing developer can retire for any reason if they need to step back from working on MESA.
56
56
57
-
At times it may be required to forcibly remove an individual from the developer community. This is a serious action and should not be taken lightly. Reasons for this may include (but not limited to) violations of the code of conduct, abuse or harassment of others, or issues of scientific integrity.
57
+
At times it may be required to forcibly remove an individual from the developer community. This is a serious action and should not be taken lightly. Reasons for this may include (but are not limited to) violations of the code of conduct, abuse or harassment of others, or issues of scientific integrity.
58
58
59
59
In the event that a developer needs to be removed, then an existing developer should call a vote to remove the person. This vote should be seconded by another developer. Removal then requires a majority of existing developers to vote for removal. If the developer is removed then commit access to MESA will be removed, as well as the developer's access to the MESA developers communication channels (slack, mesa-dev).
60
60
61
61
In exceptional time-sensitive circumstances the administrators of the MESA infrastructure (mailing lists, github, slack, testhub) may suspend a developer's access if they feel that waiting for a vote would not be appropriate. Reasons can include (but are not limited to): posting abusive messages, denial or degradation of service, committing malicious code, or other actions that the admin feels is damaging the infrastructure. This is not a removal from being a developer, but should be considered a serious issue. The admin should discuss their reasons at the earliest opportunity with the other developers, and this must lead either to a vote to remove the developer or a clear path toward ending the suspension.
62
62
63
-
Approving this document
63
+
Approving This Document
64
64
-----------------------
65
65
66
-
As we do not currently have a process for approving documents of this nature we need to bootstrap this process.
66
+
This document was approved by unanimous consent of the current MESA Developers as of December 2022.
67
67
68
-
Once the document has been iterated on it will be put to a vote of all current developers. Hopefully we can iterate this such that everyone is happy before we put this document to a vote. If someone has serious concerns then please raise them before the vote.
69
-
Acceptance will require unanimous consent.
70
-
Abstentions will count as implicit approval. Thus only a direct no vote will count against it.
71
-
The vote will be held on slack (and emailed to mesa-dev) with an appropriate period of time for people to read and approve this document.
72
-
73
-
Changing this document
68
+
Changing This Document
74
69
----------------------
75
70
76
-
Once approved changes to this document will follow the same process as the initial approval process.
71
+
Changes to this document will follow the same process as the initial approval process.
77
72
73
+
Changes will be put to a vote of all current developers. If someone has serious concerns then please raise them before the vote.
74
+
Acceptance will require unanimous consent.
75
+
Abstentions will count as implicit approval. Thus only a direct no vote will count against it.
76
+
The vote will be held on slack (and emailed to mesa-dev) with an appropriate period of time for people to read and approve this document.
0 commit comments