Skip to content

Editorial checklist

Use this before publishing a new page or major update.

Basics

  • [ ] Title is short and specific
  • [ ] Links are clickable Markdown links
  • [ ] Sources are linked inline
  • [ ] Page has the right section (Groups / People / Ops / Tools / Patterns / Notes / Blog)
  • [ ] Tags are added when useful

Quality

  • [ ] Facts are separated from inference
  • [ ] Primary name follows operator, maintainer, project, or other firsthand usage when durable public sourcing supports it
  • [ ] Alternate names are attributed to the vendor or report that used them
  • [ ] Motivation is phrased carefully
  • [ ] Tooling is described at the right level of detail
  • [ ] People pages only name individuals who are clearly supported by public sources
  • [ ] Team dynamics are only stated when the sources support them
  • [ ] No unsupported human attribution

Maintenance

  • [ ] Update mkdocs.yml nav if needed
  • [ ] Update the landing page recent entries if needed
  • [ ] Add/update blog entry for notable new material
  • [ ] Keep the checklist itself current as the site evolves