From d0a52903d539972f886514def52e60f6b4c31b1d Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Fri, 20 Nov 2020 15:29:35 -0500 Subject: [PATCH] doc: provide more context on techinical values In the discussion of https://github.com/nodejs/node/pull/35323 it was suggested that we should add some additional context/clarification to the technical values documented for the project. Signed-off-by: Michael Dawson --- doc/guides/technical-values.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/guides/technical-values.md b/doc/guides/technical-values.md index fd4e18a485af10..afbf6adce02986 100644 --- a/doc/guides/technical-values.md +++ b/doc/guides/technical-values.md @@ -3,6 +3,18 @@ The project uses these technical values to establish priorities and guide collaboration. +These values reflect the shared values of the +collaborators as of this writing and will change +and evolve. We hope they are useful to people new +to the project in order to better understand which contributions +will be aligned with the current direction and as thinking +points when trading off between conflicting goals. + +The factors influencing every discussion/decision are +different and priority 1 does not always trump priority 2 +and so on. Instead, they reflect priorities that we +should factor into key discussion/decisions. + ## Values and priority level * Priority 1 - Developer experience