Page MenuHomePhabricator

Review and update the Content Audit checklist
Closed, ResolvedPublic

Description

The Content Audit checklist contains some instructions that may be too complex or too difficult for beginning technical writers. This task aligns with parallel work to refine our understanding of what makes a good first task (T391606), and what types of tech docs improvements can be made via instructions, like in a checklist, vs. what is too contextual or requires professional expertise.

Work to do:

  • Talk to doc mentors, and review content created by new contributors during WMA Hackathon to identify recurring challenges or areas of confusion.
  • Review the Content Audit checklist at https://www.mediawiki.org/wiki/Documentation/Toolkit/Content_audit
  • Remove or revise checklist content that may be too difficult or advanced for new contributors.
  • Get feedback from new contributors about the checklist.
  • Revise the page or propose changes for review by the Tech Docs team.

Event Timeline

Proposed revision is at https://www.mediawiki.org/wiki/User:TBurmeister_(WMF)/Sandbox/Content_review.

The primary changes are:

TBurmeister changed the task status from Open to In Progress.Jun 19 2025, 3:00 PM
TBurmeister triaged this task as Low priority.

For details of the larger proposed content revisions for the review checklists, see: T391271