Skip to content

Latest commit

 

History

History
24 lines (21 loc) · 1.97 KB

NEW-STANDARD.md

File metadata and controls

24 lines (21 loc) · 1.97 KB
Raw

New Standard Checklist

When adding a new WHATWG standard, here is a checklist that needs to be considered. When coordination is required with the SG or an administrator of the WHATWG GitHub, the step is prefixed with SG/admin.

  1. Identify a shortname that is used for the spec.whatwg.org subdomain and repository (for tooling it is important that these are named identically).
    1. SG/admin: ensure the subdomain works and is configured:
      1. Update and deploy https://github.com/whatwg/misc-server.
      2. Configure the new A record on the DigitalOcean control panel.
    2. SG/admin: ensure there is a repository under the whatwg GitHub organization.
      1. Give PR Preview access to the new repository (through organization settings).
      2. Run labels.py with appropriate --repository and --token parameters to create appropriate labels for the new repository.
      3. Fill in "Edit repository details" on the frontpage of the repository (button next to About).
      4. Add branch protection for the default branch.
      5. Add the editors to the repository with Role: Write.
      6. Add @whatbot to the repository with Role: Write so it can perform participant agreement checks.
      7. Add the @whatwg/triage team to the repository with Role: Triage.
      8. Disable "Wikis" and "Allow merge commits". Enable "Automatically delete head branches".
  2. Create an SVG logo in the right shade of green (i.e., WHATWG green) and add it to https://github.com/whatwg/whatwg.org/tree/main/resources.whatwg.org.
  3. SG/admin: create a Twitter account.
    1. SG/admin: use https://github.com/whatwg/whattweetbot-keys to get the relevant keys.
  4. Add the standard to https://github.com/whatwg/sg/blob/main/db.json and ensure the relevant details are filled in. (In case a new Workstream is needed an issue will have to be filed with the SG first for review.)
  5. SG/admin: run https://github.com/whatwg/spec-factory.

You should be all set. When in doubt reach out to the Steering Group.