Closed lucasgonze closed 2 weeks ago
As I get deeper into the project I am rethinking it. The documents in the community repo are years behind the documents in the magma repo. What I should do is
Review each of the following:
Dup of file in magma repo. Out of date. Proposed resolution: possibly this file, then rearchive community repo.
Dup of file in magma repo. Out of date. Proposed resolution: possibly this file, then rearchive community repo.
This file is missing from the magma repo. Maybe it should be copied over to that repo. (But first verify that this information isn't elsewhere already).
Good information about project social structures. Should be part of governance documentation. Consolidate with info in community/Governance.md
[x] ../community/README.md
Check that this info is all in the magma/README.md file.
Rewrite to explain that the community repo is no longer where these documents live.
Rearchive community repo.
[x] ../community/Reviewing.md
Self-evident information, probably from a very early stage of the project. Delete file before rearchiving.
Dup of file in magma repo. Out of date. Proposed resolution: possibly this file, then rearchive community repo.
Badly broken. For some reason TSC governance information is in there. This needs a complete rewrite.
Merge this information into the README, then delete this file.
Rethink these items:
Weighted Voting
List Of Reward Eligible GIthub Issues
[ ] ../magma/SECURITY.md
Check that this is in sync with https://github.com/magma/magma/security/policy. Consider removing magma/SECURITY.md file to be sure they can't get out sync.
Read the details to be sure they are still accurate
Resolved: use a monorepo instead of a multirepo.
Code of conduct files have only a trivial syntax difference.
CONTRIBUTING.md:
The goop in magma/CONTRIBUTING is the technical charter, as Kendall called it at the time. Need to figure out where that really goes.
Prior art for good CONTRIBUTING files:
WTF: there also exists a repo called https://github.com/magma/Governance
The state of this list is a mess. I need to re-review and document every item.
Archived /magma/community repo
All remaining items have been reviewed and either implemented or I have decided they were defined before I full understood the project structure.
Most of the governance documents should live in the magma/community repository, not in the magma/magma repository, which is for code. However the community repo:
Tasks: