diff options
Diffstat (limited to 'docs/core.md')
| -rw-r--r-- | docs/core.md | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/core.md b/docs/core.md new file mode 100644 index 0000000..d73b122 --- /dev/null +++ b/docs/core.md @@ -0,0 +1,28 @@ +# 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. |