aboutsummaryrefslogtreecommitdiffstats
path: root/docs/core.md
blob: 1e16d54b8207b9c95b69bdb6da822eeff3f97bf2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# Core Rules and Guidelines for Standards

The following contain both requirements and guidelines for producing
Standards documents.

## Terms

- Standards review group (*SRG*): assigned group which reviews and
  approves changes to the Standards.

## Requirements

- The SRG MUST review outstanding change requests (PRs) every two weeks
  (14 days).
- PRs MUST remain open for comment no less than 5 business days (or one
  week).
  - PRs MAY remain open for more than 2 weeks if the discussion is
    active and ongoing.
- The SRG MUST publish Standards no more frequently than once per week,
  nor less frequently than once every three months.

Docuents MUST:

- Follow [RFC-2119](rfc2119.txt).
- Be as specific as possible (e.g., no colloquial langauge).
- Be concise and use [active
  voice](https://writing.wisc.edu/handbook/style/ccs_activevoice/).
- Capitalize all words in headings.
- Use American English spellings and conventions.

## Guidelines

All Standards documents:

- SHOULD follow the [Google Style
  Guide](https://developers.google.com/style/lists#capitalization-and-end-punctuation)
  for punctuation and capitalization.