Skip to content
This repository has been archived by the owner on Jul 11, 2024. It is now read-only.

review levels & changelog

Shawn Lawton Henry edited this page Sep 17, 2022 · 8 revisions

Reviews

Depending on the type of change:

  1. None -- No review needed, for example: typo fix. Do not list in changelog.
  2. List only -- No review before publication, per EO's process for minor changes. List in changelog (and point EOWG and others to changelog for review).
  3. Some review -- At least two people with expertise in the topic indicate their approval in GitHub. List in changelog (and point EOWG and others to changelog for review).
  4. Working Group Approval -- EOWG, AG WG, and/or ARIA WG based on the content. The Group's Chairs will coordinate review, e.g., through survey or other. List in changelog.

Goals of this changelog:

  1. Help reviewers know which are the more significant changes to focus on, and help them not get bogged down on less important ones.
  2. Help tutorial users know if advice they previously followed has changed.

Initial idea -- feel free to suggest different Start each change list item with:

  • [significant change]
  • [minor wording only]
  • ... ???

Dates in footer

All pages should have

<p><strong>Date:</strong> Updated @@ Month 2022. First published September 2014. CHANGELOG.</p>

At some point we might add "Up-to-date Month 2023" when we review a page and determine no updates are needed.

Clone this wiki locally