1
Fork 0

maintainers: update the section

We have a new maintainer. Also clarify what they can and cannot do.
main
Motiejus Jakštys 2023-04-28 20:23:41 +03:00 committed by Motiejus Jakštys
parent e319ac4635
commit b3d3be2049
1 changed files with 33 additions and 9 deletions

View File

@ -424,18 +424,41 @@ Previous communications were done in an email list; the past archive is in
## Maintainers ## Maintainers
This section lists the driving forces behind `hermetic_cc_toolchain`. Committers have push This section lists the driving forces behind `hermetic_cc_toolchain`.
access, maintainers have their areas. Should make it easier to understand our Committers have write access, maintainers own their areas. Should make it
interests when reading patches or mailing lists. easier to understand our interests when reading patches or mailing lists.
- Maintainers: Motiejus Jakštys, Laurynas Lubys, Zhongpeng Lin and Sung Yoon - Maintainers: Motiejus Jakštys, Laurynas Lubys, Zhongpeng Lin, Sung Yoon Whang
Whang. and Jeremy Volkman.
- Committer for Windows: Fabian Hahn. If you make a change that breaks - Maintainer for Windows: Fabian Hahn.
Windows, Fabian will find you. Please don't break Windows, so Fabian doesn't
have to look for you. Instead, send him your patches first.
You may find contact information of the individuals in the commit logs. Guidelines for maintainers:
$ zig zen
* Communicate intent precisely.
* Edge cases matter.
* Favor reading code over writing code.
* Only one obvious way to do things.
* Runtime crashes are better than bugs.
* Compile errors are better than runtime crashes.
* Incremental improvements.
* Avoid local maximums.
* Reduce the amount one must remember.
* Focus on code rather than style.
* Resource allocation may fail; resource deallocation must succeed.
* Memory is a resource.
* Together we serve the users.
On a more practical note:
- Maintainers can merge others' pull requests following their best judgement.
They may or may not ask for feedback from other maintainers. Follow the Zen
of Zig.
- Releases are cut by Uber employees, because they can test the
version-to-be-released with our [Go Monorepo][go-monorepo]. If you use
`hermetic_cc_toolchain` in any serious capacity, we encourage you to make
yourself known, so we can work together to validate it before cutting the
release.
[^1]: a [mathematical subset][subset]: both can be equal. [^1]: a [mathematical subset][subset]: both can be equal.
@ -446,3 +469,4 @@ You may find contact information of the individuals in the commit logs.
[transitions]: https://docs.bazel.build/versions/main/skylark/config.html#user-defined-transitions [transitions]: https://docs.bazel.build/versions/main/skylark/config.html#user-defined-transitions
[subset]: https://en.wikipedia.org/wiki/Subset [subset]: https://en.wikipedia.org/wiki/Subset
[universal-headers]: https://github.com/ziglang/universal-headers [universal-headers]: https://github.com/ziglang/universal-headers
[go-monorepo]: https://www.uber.com/blog/go-monorepo-bazel/