Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: add initial version of values and prios doc #11

Merged
merged 40 commits into from
Sep 9, 2020
Merged
Changes from 4 commits
Commits
Show all changes
40 commits
Select commit Hold shift + click to select a range
2a79cc9
doc: add initial version of values and prios doc
mhdawson Aug 12, 2020
18c3d7b
squash: formatting fixup
mhdawson Aug 12, 2020
a2827f0
Formatting fixup
mhdawson Aug 12, 2020
ace698b
squash: add some clarification on priorities
mhdawson Aug 12, 2020
0101bc8
Update VALUES_AND_PRIORITIZAION.md
mhdawson Aug 18, 2020
f424184
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
88e73a8
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
29b4066
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
15d6f57
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
83bd288
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
b8c6cba
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
6e6dc43
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
03180ce
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
1b9add1
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
4ca03bd
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
a9b1572
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
5cd7b42
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
0c5a689
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
430ff3d
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
d969782
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
0ffe41b
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
fd78408
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
eb154e6
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
bed1422
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
a3920d7
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
0e7f503
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
b10b7e2
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
0ecf049
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
da15225
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
d7823b9
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
ade5e1d
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
c295415
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
79e1547
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
523199a
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 2, 2020
9705794
address comments
mhdawson Sep 2, 2020
994da56
address comments
mhdawson Sep 2, 2020
7bded33
fix up bullet formatting
mhdawson Sep 2, 2020
34690ea
fixup
mhdawson Sep 2, 2020
324a474
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 4, 2020
411d080
Update VALUES_AND_PRIORITIZAION.md
mhdawson Sep 4, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 47 additions & 0 deletions VALUES_AND_PRIORITIZAION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Values and Priorities

> Document Status: Proposal, Work In Progress

## Context

Define the `Technical` values shared by the project and their relatively priority
trivikr marked this conversation as resolved.
Show resolved Hide resolved
that are applied when making tradeoffs.
mhdawson marked this conversation as resolved.
Show resolved Hide resolved


## Values and priority level

This is only a subset of the overall prioties, listing only those which are at the
mhdawson marked this conversation as resolved.
Show resolved Hide resolved
top of the priority list. Anthing on this list is very important for the project
mhdawson marked this conversation as resolved.
Show resolved Hide resolved
despite the relative priorities shown.

- Prio 1 - Developer experience
- Prio 2 - Stability
- Prio 3 - Operational qualities
- Prio 4 - Technology and API Currency
mhdawson marked this conversation as resolved.
Show resolved Hide resolved
mhdawson marked this conversation as resolved.
Show resolved Hide resolved

## Value descriptions

### Developer Experience
- Approachability (both technical and community)
- Great Documentation
mhdawson marked this conversation as resolved.
Show resolved Hide resolved

### Stability
- Backwards compatibility
- Clear expectations set around support?
- LTS support for users still using older versions of Node
mhdawson marked this conversation as resolved.
Show resolved Hide resolved

### Operational Qualities
- Performance
- Throughput, size, startup time
mhdawson marked this conversation as resolved.
Show resolved Hide resolved
- Diagnostics
- Security
mhdawson marked this conversation as resolved.
Show resolved Hide resolved

mhdawson marked this conversation as resolved.
Show resolved Hide resolved
### Technology and API currency
mhdawson marked this conversation as resolved.
Show resolved Hide resolved
mhdawson marked this conversation as resolved.
Show resolved Hide resolved
- Up to date and current APIs and technologies
- Adoption of new technologies
- Web API compatibility, standards compliance
mhdawson marked this conversation as resolved.
Show resolved Hide resolved

## 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)