General Review Checklist for All Documents

This checklist is NOT intended as a starting point to write a document.
It does NOT necessarily cover all aspects relevant for this type of document.
This checklist is intended only as an aid in checking a completed document.

  1. Have the ESA SE Standards been applied properly? (Mandatory Practices, Table of Contents, Guidelines.)
  2. Has the document been subjected to the project's Quality Assurance procedures? (SQAP, e.g. spelling & grammar check.)
  3. Has the document been entered into the the project's Configuration Management system? (SCMP.)
  4. If applicable:
    1. Has the document been subjected to an internal review? (SVVP)
    2. Does the document have line numbers?
    3. Has the Document Status Sheet been updated? Have dates been mentioned for internal and external reviews?
    4. Is the Document Change Record sufficiently detailed? Who edited what in what place and with what purpose? (e.g. "Section 2.5: Added caption to Figure 2.1")
  5. Are all open issues clearly marked as such? (TBD=`To Be Defined'.)
  6. Is the relationship to prerequisite documents explicitly stated? (e.g. in SRD, link to URD should be clear)
  7. Is the content consistent with other documents?
  8. Is terminology used consistently, both within a document and across documents? (One term for one thing. Each term refers to only one thing, each thing is referred to by only one term.)
  9. Is the section of Definitions, acronyms, and abbreviations complete? (Possibly include reference from this section to main text for details.)
  10. Is duplication of information avoided? (Cross-reference, rather than copy.)
    In particular,
  11. Are the references to other material
    1. complete? (No missing references, e.g. to Interface Control Document (ICD).)
    2. precise? (Including author(s), title, publisher, year, and for journals also volume/number.)
    3. generally accessible and durable? (Not to a webpage that is likely to disappear soon.)


©2001, Tom Verhoeff (TUE)
Feedback about this page is welcome