## Editorial Rules

Make sure all documents on this project adhere to these principles.
Make edits as needed when editing documents to keep them in alignment with these writing
principles.

1. **Use clear and concise language:**
   - Eliminate unnecessary or extraneous words.
   - Be casual, not overly stiff or formal.

2. **Use clear structure:**
   - Use headings, subheadings, lists, and other structural devices effectively.
   - Keep structure logical and consistent.
   - Make headings specific—cleave to the true contours of the subject matter.

3. **Be detailed and specific:**
   - Avoid vagueness or generalities.
   - Use concrete examples and quality citations whenever possible.

4. **Be efficient:**
   - Avoid obvious statements.
   - Remove duplication where a document says the same thing in different places.

5. **Be respectful of the reader’s intelligence:**
   - Write for a reader that is highly intelligent even if they are highly ignorant of
     the subject.
   - Explain concepts (or cite good sources) clearly and consisely from first
     principles.
   - Never dumb things down, be vague, or skip important technicalities or details.

6. **Be warm:**
   - Be friendly in tone.
   - Be gracious in acknowledging previous work, even if correcting it.
