From 2a79cc99d30294d92174a9fb4f146d4d334ee905 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 12 Aug 2020 13:21:46 -0400 Subject: [PATCH 01/40] doc: add initial version of values and prios doc Signed-off-by: Michael Dawson --- VALUES_AND_PRIORITIZAION.md | 43 +++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 VALUES_AND_PRIORITIZAION.md diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md new file mode 100644 index 0000000..c272d0d --- /dev/null +++ b/VALUES_AND_PRIORITIZAION.md @@ -0,0 +1,43 @@ +# Values and Priorities + +> Document Status: Proposal, Work In Progress + +## Context + +Define the `Technical` values shared by the project and their relatively priority +that are applied when making tradeoffs. + + +## Values and priority level + +Prio 1 - Developer experience +Prio 2 - Stability +Prio 3 - Operational qualities +Prio 4 - Technology and API Currency + +## Value descriptions + +### Developer Experience + - Approachability (both technical and community) + - Great Documentation + +### Stability + - Backwards compatibility + - Clear expectations set around support? + - LTS support for users still using older versions of Node + +### Operational Qualities + - Performance + - Throughput, size, startup time + - Diagnostics + - Security + +### Technology and API currency + - Up to date and current APIs and technologies + - Adoption of new technologies + - Web API compatibility, standards compliance + +## References + +[First pass at list of values](https://github.com/nodejs/next-10/issues/5) +[Original priorities brainstorm document](https://docs.google.com/document/d/1sbO_zCn9n_JH2zuGtqNAahUhA_mGFA89DdAme8nEdsw) From 18c3d7b13541bd627a98546a6132598f25dd7ca0 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 12 Aug 2020 13:23:50 -0400 Subject: [PATCH 02/40] squash: formatting fixup --- VALUES_AND_PRIORITIZAION.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index c272d0d..dc995c2 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -10,10 +10,10 @@ that are applied when making tradeoffs. ## Values and priority level -Prio 1 - Developer experience -Prio 2 - Stability -Prio 3 - Operational qualities -Prio 4 - Technology and API Currency +- Prio 1 - Developer experience +- Prio 2 - Stability +- Prio 3 - Operational qualities +- Prio 4 - Technology and API Currency ## Value descriptions From a2827f0c704c689a456c18d1f9fa3023fa861883 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 12 Aug 2020 13:24:05 -0400 Subject: [PATCH 03/40] Formatting fixup --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index dc995c2..68697a5 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -10,7 +10,7 @@ that are applied when making tradeoffs. ## Values and priority level -- Prio 1 - Developer experience +- Prio 1 - Developer experience - Prio 2 - Stability - Prio 3 - Operational qualities - Prio 4 - Technology and API Currency From ace698b61288ca06f895600de9953c76f4a5c1ae Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 12 Aug 2020 13:25:56 -0400 Subject: [PATCH 04/40] squash: add some clarification on priorities --- VALUES_AND_PRIORITIZAION.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 68697a5..d5de1b0 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -10,6 +10,10 @@ that are applied when making tradeoffs. ## Values and priority level +This is only a subset of the overall prioties, listing only those which are at the +top of the priority list. Anthing on this list is very important for the project +despite the relative priorities shown. + - Prio 1 - Developer experience - Prio 2 - Stability - Prio 3 - Operational qualities From 0101bc82cf4f9f27dd373b9e818627b769e9a760 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Tue, 18 Aug 2020 14:56:55 -0400 Subject: [PATCH 05/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Richard Lau --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index d5de1b0..0629933 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -11,7 +11,7 @@ that are applied when making tradeoffs. ## Values and priority level This is only a subset of the overall prioties, listing only those which are at the -top of the priority list. Anthing on this list is very important for the project +top of the priority list. Anything on this list is very important for the project despite the relative priorities shown. - Prio 1 - Developer experience From f424184bf5dbdca3564fb1bdf0fcab0576872f46 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 10:21:15 -0400 Subject: [PATCH 06/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 0629933..103a8bd 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -17,7 +17,8 @@ despite the relative priorities shown. - Prio 1 - Developer experience - Prio 2 - Stability - Prio 3 - Operational qualities -- Prio 4 - Technology and API Currency +- Prio 4 - Node.js maintainer experience +- Prio 5 - Technology and API Currency ## Value descriptions From 88e73a800db82b894f4437ce776279ab720ad15b Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 10:40:49 -0400 Subject: [PATCH 07/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 103a8bd..6306ae7 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -23,8 +23,11 @@ despite the relative priorities shown. ## Value descriptions ### Developer Experience - - Approachability (both technical and community) +We value ensuring that developers are productive and enjoy developing with Node.js. Some key elements of this include: + - Approach-ability (both technical and community) - Great Documentation + - Bundling API/components which reduce the friction of using them, even though they could be external + - Enabling/supporting external packages to ensure overall developer experience ### Stability - Backwards compatibility From 29b4066d3b62ef9761e291be8ea19949eeee17dc Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 10:44:35 -0400 Subject: [PATCH 08/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 6306ae7..7816bdc 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -30,9 +30,11 @@ We value ensuring that developers are productive and enjoy developing with Node. - Enabling/supporting external packages to ensure overall developer experience ### Stability +We value keeping Node.js stable and consistent across releases versus introducing breaking changes that require churn in the ecosystem. Some key elements of this include: - Backwards compatibility - - Clear expectations set around support? - - LTS support for users still using older versions of Node + - Predictable and stable releases + - A strong safety net (testing etc.) + - Careful consideration of what goes into LTS releases ### Operational Qualities - Performance From 15d6f570cb677ca0e5b7fe75ab6eaf89cc7d2cd2 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 10:52:50 -0400 Subject: [PATCH 09/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 7816bdc..66ef8a3 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -37,10 +37,13 @@ We value keeping Node.js stable and consistent across releases versus introducin - Careful consideration of what goes into LTS releases ### Operational Qualities - - Performance - - Throughput, size, startup time - - Diagnostics - - Security +We value keeping Node.js safe, performant and light weight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: + - throughput(speed) + - startup time + - binary size + - memory footprint + - Debug tooling (debugger) + - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) ### Technology and API currency - Up to date and current APIs and technologies From 83bd288f958e53321c6e363b237dab80de171507 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 11:03:03 -0400 Subject: [PATCH 10/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 66ef8a3..d870dcd 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -46,9 +46,10 @@ We value keeping Node.js safe, performant and light weight as well as the abilit - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) ### Technology and API currency - - Up to date and current APIs and technologies - - Adoption of new technologies - - Web API compatibility, standards compliance +We value providing developers with modern APIs and technologies following existing standards whenever possible. Some key elements of this include: + - participating in standards work and organizations + - web API compatibility + - supporting new technologies and standards and exposing them early in their life-cycle ## References From b8c6cbafe3e9b2710b42c9a1c63533878ada13fb Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 11:09:41 -0400 Subject: [PATCH 11/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index d870dcd..c42f2e2 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -44,7 +44,12 @@ We value keeping Node.js safe, performant and light weight as well as the abilit - memory footprint - Debug tooling (debugger) - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) - +### Node.js maintainer experience +We value ensuring that Node.js maintainers are productive and enjoy maintaining Node.js and related components. Some key elements of this include: +- Approach-ability of the code base +- Good internal documentation and guides +- Low friction policies and processes +- Good CI and tooling to make maintainers productive ### Technology and API currency We value providing developers with modern APIs and technologies following existing standards whenever possible. Some key elements of this include: - participating in standards work and organizations From 6e6dc4372c0477fe841fec652632af72bcf1ca05 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 11:10:23 -0400 Subject: [PATCH 12/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index c42f2e2..4a01961 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -43,7 +43,8 @@ We value keeping Node.js safe, performant and light weight as well as the abilit - binary size - memory footprint - Debug tooling (debugger) - - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) +- Diagnostic tooling (profilers, heapdumps, coredumps, etc.) + ### Node.js maintainer experience We value ensuring that Node.js maintainers are productive and enjoy maintaining Node.js and related components. Some key elements of this include: - Approach-ability of the code base From 03180cec1fee6362f83c6359a1b0ae1ba023408c Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 11:10:45 -0400 Subject: [PATCH 13/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 1 + 1 file changed, 1 insertion(+) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 4a01961..774712e 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -51,6 +51,7 @@ We value ensuring that Node.js maintainers are productive and enjoy maintaining - Good internal documentation and guides - Low friction policies and processes - Good CI and tooling to make maintainers productive + ### Technology and API currency We value providing developers with modern APIs and technologies following existing standards whenever possible. Some key elements of this include: - participating in standards work and organizations From 1b9add10fbe7d00864ada6d19064abcbd40ece38 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 11:11:48 -0400 Subject: [PATCH 14/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 774712e..b09cf38 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -38,12 +38,12 @@ We value keeping Node.js stable and consistent across releases versus introducin ### Operational Qualities We value keeping Node.js safe, performant and light weight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: - - throughput(speed) - - startup time - - binary size - - memory footprint - - Debug tooling (debugger) -- Diagnostic tooling (profilers, heapdumps, coredumps, etc.) + - Throughput(speed) + - Startup time + - Binary size + - Memory footprint + - Debug tooling (debugger) + - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) ### Node.js maintainer experience We value ensuring that Node.js maintainers are productive and enjoy maintaining Node.js and related components. Some key elements of this include: From 4ca03bd2a905fd90399ac088aa0f43d80eb1879b Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 11:13:57 -0400 Subject: [PATCH 15/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index b09cf38..eba7fe6 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -38,12 +38,8 @@ We value keeping Node.js stable and consistent across releases versus introducin ### Operational Qualities We value keeping Node.js safe, performant and light weight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: - - Throughput(speed) - - Startup time - - Binary size - - Memory footprint - - Debug tooling (debugger) - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) + - Addressing security vulnerabilities in a responsible maner ### Node.js maintainer experience We value ensuring that Node.js maintainers are productive and enjoy maintaining Node.js and related components. Some key elements of this include: From a9b15724a3fed49fa1ac3981b53f12b23f9a708a Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 11:15:46 -0400 Subject: [PATCH 16/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index eba7fe6..bf1be03 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -37,7 +37,12 @@ We value keeping Node.js stable and consistent across releases versus introducin - Careful consideration of what goes into LTS releases ### Operational Qualities -We value keeping Node.js safe, performant and light weight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: +We value keeping Node.js safe, performant and light weight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: + - Throughput(speed) + - Startup time + - Binary size + - Memory footprint + - Debug tooling (debugger) - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) - Addressing security vulnerabilities in a responsible maner From 5cd7b424d73dd07b519420a843793032a9818600 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:03:39 -0400 Subject: [PATCH 17/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Joe Sepi --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index bf1be03..d22b97d 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -10,7 +10,7 @@ that are applied when making tradeoffs. ## Values and priority level -This is only a subset of the overall prioties, listing only those which are at the +This is only a subset of the overall priorities, listing only those which are at the top of the priority list. Anything on this list is very important for the project despite the relative priorities shown. From 0c5a689fc63d498d849c60c9354fcc90859f6db5 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:03:48 -0400 Subject: [PATCH 18/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Trivikram Kamat <16024985+trivikr@users.noreply.github.com> --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index d22b97d..0f925ff 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -37,7 +37,7 @@ We value keeping Node.js stable and consistent across releases versus introducin - Careful consideration of what goes into LTS releases ### Operational Qualities -We value keeping Node.js safe, performant and light weight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: +We value keeping Node.js safe, performant and lightweight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: - Throughput(speed) - Startup time - Binary size From 430ff3d6e0f9d067661d4e952ba6448ddef36951 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:03:57 -0400 Subject: [PATCH 19/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Trivikram Kamat <16024985+trivikr@users.noreply.github.com> --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 0f925ff..7e4804c 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -18,7 +18,7 @@ despite the relative priorities shown. - Prio 2 - Stability - Prio 3 - Operational qualities - Prio 4 - Node.js maintainer experience -- Prio 5 - Technology and API Currency +- Prio 5 - Technology and API currency ## Value descriptions From d9697822ebaa68a2457beb5efadd93f9d5dd2294 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:04:06 -0400 Subject: [PATCH 20/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Trivikram Kamat <16024985+trivikr@users.noreply.github.com> --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 7e4804c..88464a7 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -44,7 +44,7 @@ We value keeping Node.js safe, performant and lightweight as well as the ability - Memory footprint - Debug tooling (debugger) - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) - - Addressing security vulnerabilities in a responsible maner + - Addressing security vulnerabilities in a responsible manner ### Node.js maintainer experience We value ensuring that Node.js maintainers are productive and enjoy maintaining Node.js and related components. Some key elements of this include: From 0ffe41b2505d0227276934405ee092b5622d0734 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:04:16 -0400 Subject: [PATCH 21/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 88464a7..2e5d956 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -24,7 +24,7 @@ despite the relative priorities shown. ### Developer Experience We value ensuring that developers are productive and enjoy developing with Node.js. Some key elements of this include: - - Approach-ability (both technical and community) + - Approachability (both technical and community) - Great Documentation - Bundling API/components which reduce the friction of using them, even though they could be external - Enabling/supporting external packages to ensure overall developer experience From fd78408f419152bd3f714d718dc4e4f001f22b1e Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:04:28 -0400 Subject: [PATCH 22/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Trivikram Kamat <16024985+trivikr@users.noreply.github.com> --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 2e5d956..190fbfc 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -54,7 +54,7 @@ We value ensuring that Node.js maintainers are productive and enjoy maintaining - Good CI and tooling to make maintainers productive ### Technology and API currency -We value providing developers with modern APIs and technologies following existing standards whenever possible. Some key elements of this include: +We value providing developers with modern APIs and technologies following existing standards whenever possible. Some key elements of this include: - participating in standards work and organizations - web API compatibility - supporting new technologies and standards and exposing them early in their life-cycle From eb154e617319c96af1c44d873d2b4967d1bbfc76 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:04:36 -0400 Subject: [PATCH 23/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Trivikram Kamat <16024985+trivikr@users.noreply.github.com> --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 190fbfc..9e8977c 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -38,7 +38,7 @@ We value keeping Node.js stable and consistent across releases versus introducin ### Operational Qualities We value keeping Node.js safe, performant and lightweight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: - - Throughput(speed) + - Throughput (speed) - Startup time - Binary size - Memory footprint From bed1422589fe08572380bff7fee4d837be52c2b6 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:04:53 -0400 Subject: [PATCH 24/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 9e8977c..d2f70a2 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -26,7 +26,7 @@ despite the relative priorities shown. We value ensuring that developers are productive and enjoy developing with Node.js. Some key elements of this include: - Approachability (both technical and community) - Great Documentation - - Bundling API/components which reduce the friction of using them, even though they could be external + - Bundling friction-reducing APIs and components, even though they could be provided externally - Enabling/supporting external packages to ensure overall developer experience ### Stability From a3920d70646e7271222349c05f8c08df17dd836a Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:05:11 -0400 Subject: [PATCH 25/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index d2f70a2..369550c 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -30,7 +30,7 @@ We value ensuring that developers are productive and enjoy developing with Node. - Enabling/supporting external packages to ensure overall developer experience ### Stability -We value keeping Node.js stable and consistent across releases versus introducing breaking changes that require churn in the ecosystem. Some key elements of this include: +To avoid introducing churn into Node.js' ecosystem, we value stability and consistency across releases and avoid breaking changes. Some key elements of this include: - Backwards compatibility - Predictable and stable releases - A strong safety net (testing etc.) From 0e7f503b494023550c7c6c8569f2a65754049c54 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:09:06 -0400 Subject: [PATCH 26/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 369550c..eaeb778 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -50,7 +50,7 @@ We value keeping Node.js safe, performant and lightweight as well as the ability We value ensuring that Node.js maintainers are productive and enjoy maintaining Node.js and related components. Some key elements of this include: - Approach-ability of the code base - Good internal documentation and guides -- Low friction policies and processes +- Low-friction policies and processes - Good CI and tooling to make maintainers productive ### Technology and API currency From b10b7e245c97ec9eca8abe09a65c0bf59070375e Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:09:20 -0400 Subject: [PATCH 27/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index eaeb778..e87aef5 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -55,9 +55,9 @@ We value ensuring that Node.js maintainers are productive and enjoy maintaining ### Technology and API currency We value providing developers with modern APIs and technologies following existing standards whenever possible. Some key elements of this include: - - participating in standards work and organizations - - web API compatibility - - supporting new technologies and standards and exposing them early in their life-cycle + - Participating in standards work and organizations + - Web API compatibility + - Supporting and exposing new technologies and standards through early adoption ## References From 0ecf0498b82b3979e31515bef8cd9c6f36c03008 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:09:46 -0400 Subject: [PATCH 28/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index e87aef5..1e62431 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -4,8 +4,7 @@ ## Context -Define the `Technical` values shared by the project and their relatively priority -that are applied when making tradeoffs. +Prioritize the **Technical** values shared by the project and use these to guide us when making tradeoffs. ## Values and priority level From da152256f5db500c547f9f355e077b37430084c4 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:10:43 -0400 Subject: [PATCH 29/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 1e62431..f8b0cec 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -47,7 +47,7 @@ We value keeping Node.js safe, performant and lightweight as well as the ability ### Node.js maintainer experience We value ensuring that Node.js maintainers are productive and enjoy maintaining Node.js and related components. Some key elements of this include: -- Approach-ability of the code base +- Approachability of the codebase - Good internal documentation and guides - Low-friction policies and processes - Good CI and tooling to make maintainers productive From d7823b9495b657e4b273b5a54736b036f81afb61 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:10:57 -0400 Subject: [PATCH 30/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index f8b0cec..96f49fc 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -46,7 +46,7 @@ We value keeping Node.js safe, performant and lightweight as well as the ability - Addressing security vulnerabilities in a responsible manner ### Node.js maintainer experience -We value ensuring that Node.js maintainers are productive and enjoy maintaining Node.js and related components. Some key elements of this include: +We value the productivity and happiness of Node.js' maintainers. Some key elements of this include: - Approachability of the codebase - Good internal documentation and guides - Low-friction policies and processes From ade5e1de155817232525dbc9108b7634b3b9f935 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:11:15 -0400 Subject: [PATCH 31/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 96f49fc..207df95 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -52,7 +52,7 @@ We value the productivity and happiness of Node.js' maintainers. Some key elemen - Low-friction policies and processes - Good CI and tooling to make maintainers productive -### Technology and API currency +### Technology and API Currency We value providing developers with modern APIs and technologies following existing standards whenever possible. Some key elements of this include: - Participating in standards work and organizations - Web API compatibility From c2954158ae82acd45a0844d3d3d93e56368780dd Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:11:23 -0400 Subject: [PATCH 32/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 207df95..cc12d46 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -45,7 +45,7 @@ We value keeping Node.js safe, performant and lightweight as well as the ability - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) - Addressing security vulnerabilities in a responsible manner -### Node.js maintainer experience +### Node.js Maintainer Experience We value the productivity and happiness of Node.js' maintainers. Some key elements of this include: - Approachability of the codebase - Good internal documentation and guides From 79e15470ed40ab5cedc3fe41236ce5d4addcf160 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:11:31 -0400 Subject: [PATCH 33/40] Update VALUES_AND_PRIORITIZAION.md Co-authored-by: Christopher Hiller --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index cc12d46..f1d735d 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -42,7 +42,7 @@ We value keeping Node.js safe, performant and lightweight as well as the ability - Binary size - Memory footprint - Debug tooling (debugger) - - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) + - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) - Addressing security vulnerabilities in a responsible manner ### Node.js Maintainer Experience From 523199a398ae358265f71090c30f4c3884fdb944 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:13:05 -0400 Subject: [PATCH 34/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index f1d735d..5652695 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -52,7 +52,7 @@ We value the productivity and happiness of Node.js' maintainers. Some key elemen - Low-friction policies and processes - Good CI and tooling to make maintainers productive -### Technology and API Currency +### Providing modern APIs and Technologies We value providing developers with modern APIs and technologies following existing standards whenever possible. Some key elements of this include: - Participating in standards work and organizations - Web API compatibility From 9705794e24bcd2f36d56b216dcc15f662e5803f9 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:25:06 -0400 Subject: [PATCH 35/40] address comments --- VALUES_AND_PRIORITIZAION.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 5652695..0acf93f 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -13,11 +13,11 @@ This is only a subset of the overall priorities, listing only those which are at top of the priority list. Anything on this list is very important for the project despite the relative priorities shown. -- Prio 1 - Developer experience -- Prio 2 - Stability -- Prio 3 - Operational qualities -- Prio 4 - Node.js maintainer experience -- Prio 5 - Technology and API currency +- Priority 1 - Developer experience +- Priority 2 - Stability +- Prioity 3 - Operational qualities +- Prioity 4 - Node.js maintainer experience +- Prioity 5 - Technology and API currency ## Value descriptions From 994da5652316217df9480e315df5dc3bda8004bf Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:25:32 -0400 Subject: [PATCH 36/40] address comments --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 0acf93f..0c37431 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -37,7 +37,7 @@ To avoid introducing churn into Node.js' ecosystem, we value stability and consi ### Operational Qualities We value keeping Node.js safe, performant and lightweight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: - - Throughput (speed) + - Throughput (speed) - Startup time - Binary size - Memory footprint From 7bded3316bf706c0bf2f390eb37a54ce462f5442 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:26:42 -0400 Subject: [PATCH 37/40] fix up bullet formatting --- VALUES_AND_PRIORITIZAION.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 0c37431..d6e0ee7 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -23,27 +23,27 @@ despite the relative priorities shown. ### Developer Experience We value ensuring that developers are productive and enjoy developing with Node.js. Some key elements of this include: - - Approachability (both technical and community) - - Great Documentation - - Bundling friction-reducing APIs and components, even though they could be provided externally - - Enabling/supporting external packages to ensure overall developer experience +- Approachability (both technical and community) +- Great Documentation +- Bundling friction-reducing APIs and components, even though they could be provided externally +- Enabling/supporting external packages to ensure overall developer experience ### Stability To avoid introducing churn into Node.js' ecosystem, we value stability and consistency across releases and avoid breaking changes. Some key elements of this include: - - Backwards compatibility - - Predictable and stable releases - - A strong safety net (testing etc.) - - Careful consideration of what goes into LTS releases +- Backwards compatibility +- Predictable and stable releases +- A strong safety net (testing etc.) +- Careful consideration of what goes into LTS releases ### Operational Qualities We value keeping Node.js safe, performant and lightweight as well as the ability to investigate and debug problems in development and production. Some key elements of this include: - - Throughput (speed) - - Startup time - - Binary size - - Memory footprint - - Debug tooling (debugger) - - Diagnostic tooling (profilers, heapdumps, coredumps, etc.) - - Addressing security vulnerabilities in a responsible manner +- Throughput (speed) +- Startup time +- Binary size +- Memory footprint +- Debug tooling (debugger) +- Diagnostic tooling (profilers, heapdumps, coredumps, etc.) +- Addressing security vulnerabilities in a responsible manner ### Node.js Maintainer Experience We value the productivity and happiness of Node.js' maintainers. Some key elements of this include: @@ -54,9 +54,9 @@ We value the productivity and happiness of Node.js' maintainers. Some key elemen ### Providing modern APIs and Technologies We value providing developers with modern APIs and technologies following existing standards whenever possible. Some key elements of this include: - - Participating in standards work and organizations - - Web API compatibility - - Supporting and exposing new technologies and standards through early adoption +- Participating in standards work and organizations +- Web API compatibility +- Supporting and exposing new technologies and standards through early adoption ## References From 34690ea5c740f2a7a878d62d676aa58bc4f965da Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Wed, 2 Sep 2020 17:27:24 -0400 Subject: [PATCH 38/40] fixup --- VALUES_AND_PRIORITIZAION.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index d6e0ee7..2383001 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -15,9 +15,9 @@ despite the relative priorities shown. - Priority 1 - Developer experience - Priority 2 - Stability -- Prioity 3 - Operational qualities -- Prioity 4 - Node.js maintainer experience -- Prioity 5 - Technology and API currency +- Priority 3 - Operational qualities +- Priority 4 - Node.js maintainer experience +- Priority 5 - Technology and API currency ## Value descriptions From 324a47427ad070c09197fc84efdd69b5ee19d311 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Fri, 4 Sep 2020 17:42:01 -0400 Subject: [PATCH 39/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index 2383001..bd168d4 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -32,7 +32,7 @@ We value ensuring that developers are productive and enjoy developing with Node. To avoid introducing churn into Node.js' ecosystem, we value stability and consistency across releases and avoid breaking changes. Some key elements of this include: - Backwards compatibility - Predictable and stable releases -- A strong safety net (testing etc.) +A strong safety net, including explicitly testing how changes in Node.js affect userland packages. - Careful consideration of what goes into LTS releases ### Operational Qualities From 411d080f7af556ceb3156a7d310d4eca054a1701 Mon Sep 17 00:00:00 2001 From: Michael Dawson Date: Fri, 4 Sep 2020 17:42:34 -0400 Subject: [PATCH 40/40] Update VALUES_AND_PRIORITIZAION.md --- VALUES_AND_PRIORITIZAION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VALUES_AND_PRIORITIZAION.md b/VALUES_AND_PRIORITIZAION.md index bd168d4..cee5725 100644 --- a/VALUES_AND_PRIORITIZAION.md +++ b/VALUES_AND_PRIORITIZAION.md @@ -32,7 +32,7 @@ We value ensuring that developers are productive and enjoy developing with Node. To avoid introducing churn into Node.js' ecosystem, we value stability and consistency across releases and avoid breaking changes. Some key elements of this include: - Backwards compatibility - Predictable and stable releases -A strong safety net, including explicitly testing how changes in Node.js affect userland packages. +- A strong safety net, including explicitly testing how changes in Node.js affect userland packages. - Careful consideration of what goes into LTS releases ### Operational Qualities