From da34d6f75459769b1f4cf342d61fc9502f0ce4f2 Mon Sep 17 00:00:00 2001 From: Thomas Pinder Date: Wed, 4 Oct 2023 08:29:33 +0200 Subject: [PATCH 1/4] Draft governance --- GOVERNANCE.md | 95 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 GOVERNANCE.md diff --git a/GOVERNANCE.md b/GOVERNANCE.md new file mode 100644 index 000000000..69ca84653 --- /dev/null +++ b/GOVERNANCE.md @@ -0,0 +1,95 @@ +# GPJax Governance Document + +## The Project + +GPJax is an open-source library that supports Gaussian process modelling in the JAX +scientific computation ecosystem. The abstractions provided in GPJax are designed to +mimic the underlying maths through, making the library easy to use for both researchers +and practitioners alike. + +GPJax was created by [Thomas Pinder](https://github.com/thomaspinder) as a +[Single-Maintainer Houseplant +project](https://github.com/OpenTechStrategies/open-source-archetypes/blob/main/arch-houseplant.ltx) +following the BDFL model of governance. We have since moved to the governance model of +[Specialty +Library](https://github.com/OpenTechStrategies/open-source-archetypes/blob/main/arch-specialty-library.ltx) +and benefited from a community of +[contributors](https://github.com/JaxGaussianProcesses/GPJax/graphs/contributors). This +document outlines the governance structure for the current status. + +## Roles +* Contributors: Anyone who contributes to GPJAx is considered a contributor. This + includes submitting code, filing issues, reviewing pull requests, and participating in + discussions. They are listed under: + * [https://github.com/JaxGaussianProcesses/GPJax/graphs/contributors](https://github.com/JaxGaussianProcesses/GPJax/graphs/contributors) +* Core contributors: Core contributors are contributors who have made significant + contributions to the GPJax project, for example large modules or functionality. +* GPJax gardeners: Gardeners are core contributors who are responsible for maintaining + the project and making decisions about its future direction. GPJax gardeners have the + ability to merge pull requests into the GPJax repository. GPJax gardeners also take on + administrative tasks such as website maintenance. + * Currently [thomaspinder@](https://github.com/thomaspinder) and ... are the + gardeners of GPJax. + +## Responsibility +We cannot hold anyone responsible really since we are all doing free work here, but some +general expectations are: +* Contributors are responsible for following the project's code of conduct and + contributing to the project in a positive and constructive manner. Contributors are + also responsible for testing their code and ensuring that it meets the project's + standards. +* Core contributors are expected to review pull requests and provide feedback to + contributors. They also make decisions about the architecture and implementation of + the module/functionality they contributed to. Also the β€œif you broke something please + fix it” applies. +* Maintainers are responsible for monitoring the benchmark, the documentation and the + website are up to date and built passed, update dependency and apply best practice + +In addition to these specific responsibilities, all contributors are encouraged to +participate in discussions about the project and to help out in any way they can. + +## Decision-making +Decisions about the GPJax project are made by consensus among the GPJax gardeners. This +means that all GPJax gardeners must agree on a decision before it can be implemented. If +a consensus cannot be reached, we will flip a (virtual) coin. + +## Communication +Communication about the GPJax project takes place in the following channels: + +GitHub issues: Issues are used to track bugs, feature requests, and other tasks. GitHub +discussion: Discussions are used to answer user questions, scope for features, and +discuss solutions to bugs. GitHub pull requests: Pull requests propose changes to the +GPJax codebase. Slack: The GPJax Slack Channel is used for internal communication about +the project for core contributors. + +## Contributing +Anyone is welcome to contribute to the GPJax project. Contributions can be made in the +form of code, documentation, or other forms of support. To learn more about how to +contribute, please see the [contributing +guide](https://github.com/JaxGaussianProcesses/GPJax/blob/main/static/CONTRIBUTING.md). + + +## Code of conduct +All contributors to the GPJax project are expected to follow the project's [code of +conduct](https://github.com/JaxGaussianProcesses/GPJax/blob/main/.github/CODE_OF_CONDUCT.md). +The code of conduct outlines the expected behavior of contributors and helps to ensure a +welcoming and productive environment for all. + +Any breaches of the code of conduct should be reported using our [contact +form](https://jaxgaussianprocesses.com/contact/). + + +## Governance changes +This governance document is subject to change. Changes to the governance document must +be approved by consensus among the core contributors. + + +## Contact +If you have any questions about the GPJax project, please feel free to contact the +maintainers or reach out over +[Slack](https://join.slack.com/t/gpjax/shared_invite/zt-1da57pmjn-rdBCVg9kApirEEn2E5Q2Zw). + +----- + +This file was adapted from +[BlackJAX](https://github.com/blackjax-devs/blackjax/blob/main/GOVERNANCE.md). \ No newline at end of file From bb31606181395668eeaad45f7017f149f5e7e2f9 Mon Sep 17 00:00:00 2001 From: Thomas Pinder Date: Thu, 5 Oct 2023 07:41:30 +0200 Subject: [PATCH 2/4] Add gardeners --- GOVERNANCE.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/GOVERNANCE.md b/GOVERNANCE.md index 69ca84653..1123e2223 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -28,8 +28,9 @@ document outlines the governance structure for the current status. the project and making decisions about its future direction. GPJax gardeners have the ability to merge pull requests into the GPJax repository. GPJax gardeners also take on administrative tasks such as website maintenance. - * Currently [thomaspinder@](https://github.com/thomaspinder) and ... are the - gardeners of GPJax. + * Currently [daniel-dodd@](https://github.com/daniel-dodd), + [henrymoss@](https://github.com/henrymoss), [st--@](https://github.com/st--), and + [thomaspinder@](https://github.com/thomaspinder are the gardeners of GPJax. ## Responsibility We cannot hold anyone responsible really since we are all doing free work here, but some From 44e13284f603644b1466010e136b9f92b55d859a Mon Sep 17 00:00:00 2001 From: Thomas Pinder Date: Thu, 5 Oct 2023 07:42:51 +0200 Subject: [PATCH 3/4] Move into statics --- GOVERNANCE.md => static/GOVERNANCE.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename GOVERNANCE.md => static/GOVERNANCE.md (100%) diff --git a/GOVERNANCE.md b/static/GOVERNANCE.md similarity index 100% rename from GOVERNANCE.md rename to static/GOVERNANCE.md From 8a4943df77d757b2ca9b0738c2d43888a201a1a4 Mon Sep 17 00:00:00 2001 From: Thomas Pinder Date: Thu, 5 Oct 2023 07:57:29 +0200 Subject: [PATCH 4/4] Add links to readme and docs --- README.md | 11 +++++++---- {static => docs}/GOVERNANCE.md | 2 +- mkdocs.yml | 5 +++++ 3 files changed, 13 insertions(+), 5 deletions(-) rename {static => docs}/GOVERNANCE.md (98%) diff --git a/README.md b/README.md index f9469b2a1..04c8429a1 100644 --- a/README.md +++ b/README.md @@ -25,10 +25,13 @@ with GP models. # Package support -GPJax was founded by [Thomas Pinder](https://github.com/thomaspinder). Today, -the maintenance of GPJax is undertaken by [Thomas -Pinder](https://github.com/thomaspinder) and [Daniel -Dodd](https://github.com/Daniel-Dodd). +GPJax was founded by [Thomas Pinder](https://github.com/thomaspinder). Today, the +project's gardeners are [daniel-dodd@](https://github.com/daniel-dodd), +[henrymoss@](https://github.com/henrymoss), [st--@](https://github.com/st--), and +[thomaspinder@](https://github.com/thomaspinder), listed in alphabetical order. The full governance structure of GPJax is detailed [here](docs/GOVERNANCE.md).We +appreciate all [the contributors to +GPJax](https://github.com/JaxGaussianProcesses/GPJax/graphs/contributors) who have +helped to shape GPJax into the package it is today. We would be delighted to receive contributions from interested individuals and groups. To learn how you can get involved, please read our [guide for diff --git a/static/GOVERNANCE.md b/docs/GOVERNANCE.md similarity index 98% rename from static/GOVERNANCE.md rename to docs/GOVERNANCE.md index 1123e2223..81dd7df35 100644 --- a/static/GOVERNANCE.md +++ b/docs/GOVERNANCE.md @@ -30,7 +30,7 @@ document outlines the governance structure for the current status. administrative tasks such as website maintenance. * Currently [daniel-dodd@](https://github.com/daniel-dodd), [henrymoss@](https://github.com/henrymoss), [st--@](https://github.com/st--), and - [thomaspinder@](https://github.com/thomaspinder are the gardeners of GPJax. + [thomaspinder@](https://github.com/thomaspinder) are the gardeners of GPJax. ## Responsibility We cannot hold anyone responsible really since we are all doing free work here, but some diff --git a/mkdocs.yml b/mkdocs.yml index 59fc61b2c..58e1dbba0 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -36,8 +36,13 @@ nav: - Likelihoods: examples/likelihoods_guide.py - UCI regression: examples/yacht.py - πŸ’» Raw tutorial code: give_me_the_code.md + - Community: + - πŸ‘₯ Code of conduct: CODE_OF_CONDUCT.md + - πŸ“œ Governance: GOVERNANCE.MD + - πŸ“¨ Contact: https://jaxgaussianprocesses.com/contact/ - πŸ“• Reference: api/ + theme: name: material features: