Skip to content

This is an early unpublished editor's draft; content is incomplete and subject to change.

Clear structure review

Assertion

[Title, role, or organization] asserts that:

  • Our organization has a process and policy for reviewing written content for clear structure before publication. The process includes confirming:
    • all of the core requirements in the Structure guideline are met
    • content sections are as concise as possible
    • icons are considered as possible ways to help users understand the content structure and identify key parts
    • authors consider when to turn sentences into lists to make the information easier to understand and remember
  • If a style guide is used by authors, it must provide guidance on these aspects of clear structure.
  • If author training is provided, it must provide guidance on these aspects of clear structure.

Information that needs to be included publicly:

  • title, role, or organization making the assertion (if different from the conformance claim)
  • date of when the policy was implemented
  • date of assertion (if different from the date of the conformance claim)

Recommended internal documentation (Informative):

  • copy of the policy implementing the clear structure review
  • whether training was provided for authors:
    • date training was provided
    • number or proportion of authors who completed the training
  • copy of the style guide (if any) where clear structure review has been defined

Tests

This content needs to be written.