Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.


This content is out of date: Please see the Readiness Markers page for current information on how to mark a page as needing work.

At WPD we use a system of Flags to mark articles that need work done on them. This helps the community keep track of what needs to be done and create automatic lists of things to do.

Flags are used in conjunction with Editorial templates to provide more details. Whereas flags are used to mark high-level issues and allow editors to locate articles that require specific kinds of work, Editorial notes are used to describe what specifically sections of the page require.

See more detail about each flag to see how it’s used and what Editorial notes it should be used in conjunction with.

How to add a flag

To add a flag, go to the page to be flagged, and click Edit. You should see a form. (If you don’t, the page might need to be converted to the Basic_Page template.)

In the “High-level issues” or “Content” part of the form, click the checkbox next to the appropriate flag—for example, Merge Candidate.

If you see a warning that you need to include a block with more information about the flag, add the block in the “Block of editorial notes” section. See the flag’s page for details on how to fill in the block.

For example, if you choose Merge Candidate and want the page to be merged with /docs/css/atrules, then your block should look like this:


List of work item flags

These articles mark work items that an article needs to bring it up to our quality standards. We seek to fix the issues that the flags address and get to zero work-item flags. Many of these flags are directly inspired by points in the Style Manual.

Different flags have different guidelines for when they should be used, and for if they should have editorial notes used along with them. Be sure to read the notes on each flag before using it.

TODO: Remove/archive out-of-date material, re-write page to focus on the automatically generated flags that are still in use.

Content quality (high-level)

Content quality (low-level)


See Flag Notes for background details. and historical discussion.