From a556143dc158f81b76090e60587e4627add12635 Mon Sep 17 00:00:00 2001 From: Valentin Gagarin Date: Mon, 2 Jan 2023 11:40:09 +0100 Subject: [PATCH 1/2] add objectives and tasks for Nix team so far there were no even remotely measurable objectives, only a general purpose statement. this change is intended to focus the team's work on what I (and many others I talked to) perceive to be the main pain point in the development process. Co-authored-by: solene.rapenne@tweag.io --- maintainers/README.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/maintainers/README.md b/maintainers/README.md index 08d197c1b..8289729e2 100644 --- a/maintainers/README.md +++ b/maintainers/README.md @@ -2,7 +2,22 @@ ## Motivation -The goal of the team is to help other people to contribute to Nix. +In order to attract more maintainers and thereby scale the development process to match user needs, the main goal of this team is to improve the Nix contributor experience. + +### Objectives + +- It is obvious what is worthwhile to work on. +- It is easy to find the right place in the code to make a change. +- It is clear what is expected of a pull request. +- It is predictable how to get a change merged and released. + +### Tasks + +- Elaborate contribution guides and abide to them +- Improve documentation targeted to contributors +- Maintain the issue tracker and triage pull requests +- Help competent contributors succeed with their pull requests +- Ensure the required maintainer capacity for all of the above ## Members From 164a5e2629fdd0089af11209b6ab628e81a38fc2 Mon Sep 17 00:00:00 2001 From: Valentin Gagarin Date: Fri, 24 Feb 2023 15:05:31 +0100 Subject: [PATCH 2/2] incorporate feedback from maintainers --- maintainers/README.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/maintainers/README.md b/maintainers/README.md index 8289729e2..376c381cf 100644 --- a/maintainers/README.md +++ b/maintainers/README.md @@ -2,7 +2,9 @@ ## Motivation -In order to attract more maintainers and thereby scale the development process to match user needs, the main goal of this team is to improve the Nix contributor experience. +The team's main responsibility is to set a direction for the development of Nix and ensure that the code is in good shape. + +We aim to achieve this by improving the contributor experience and attracting more maintainers – that is, by helping other people contributing to Nix and eventually taking responsibility – in order to scale the development process to match users' needs. ### Objectives @@ -13,10 +15,16 @@ In order to attract more maintainers and thereby scale the development process t ### Tasks -- Elaborate contribution guides and abide to them -- Improve documentation targeted to contributors +- Establish, communicate, and maintain a technical roadmap +- Improve documentation targeted at contributors + - Record architecture and design decisions + - Elaborate contribution guides and abide to them + - Define and assert quality criteria for contributions - Maintain the issue tracker and triage pull requests -- Help competent contributors succeed with their pull requests +- Help contributors succeed with pull requests that address roadmap milestones +- Manage the release lifecycle +- Regularly publish reports on work done +- Engage with third parties in the interest of the project - Ensure the required maintainer capacity for all of the above ## Members