Glossary documentation status

This page tries to track ongoing documentation work in the MDN Glossary. Feel free to contribute!


Pages No tags Needs* tags Missing tags Editorial reviews Technical reviews Outdated pages
530 1 (1%) 19 (4%) 125 (24%) 4 (1%) 100 (19%) 335 (64%)

See also localization status of this section.

No tags

Found 1 pages. Learn more about how to tag pages.

Needs* tags

Found 19 pages. Learn more about how to deal with meta-tags.

Missing tags

At least missing one of the following: , , , , , , , , , , , , , , , ,

Found 125 pages. Learn more about how to tag pages.

Editorial reviews

Found 4 pages. Learn more about how to do an editorial review.

Technical reviews

Found 100 pages. Learn more about how to do a technical review.

Outdated pages

Found 335 pages. These pages haven't been updated in over a year. Outdated pages can have problems with both content and format. Look at these pages and consider: Is this page talking about the Web of today? Does it look consistent with newer pages in this topic area? If not, make any needed changes.


Please help us to localize this documentation into different languages. Read more about how to translate.

Language Pages Translated Translations up to date
bn 441 6 (1%) 0 (0%)
de 441 102 (23%) 68 (66%)
es 441 167 (37%) 119 (71%)
fa 441 4 (0%) 1 (25%)
fr 521 431 (82%) 170 (39%)
it 441 23 (5%) 10 (43%)
ja 526 427 (81%) 246 (57%)
ko 528 141 (26%) 86 (60%)
pl 441 18 (4%) 9 (50%)
pt-BR 492 131 (26%) 57 (43%)
pt-PT 528 60 (11%) 26 (43%)
ru 508 156 (30%) 66 (42%)
uk 518 114 (22%) 59 (51%)
vi 446 20 (4%) 12 (60%)
zh-CN 441 184 (41%) 126 (68%)
zh-TW 441 135 (30%) 73 (54%)

Current priorities

Technical Review

There are a lot of articles flagged for technical review. You can check if they are technically correct and correct them and/or remove the flag as appropriate.

Editorial Review

Articles need to be correctly formatted and spell-checked. Here is an example of a well-formatted entry.

Cut longer articles

If an article is too long, it needs to be reduced as per guidelines here. If you think a long article is particularly well written and deserves to be preserved, discuss it with us, on the MDN discussion forum. It can be moved to the appropriate area of MDN if it's deserving of its place on the site.

General check of completeness

There are a lot of articles. We should check to see if they need content and tag them appropriately.

Use the Glossary macro

Articles in the Glossary Area, the Learning Area, and MDN, in general, should use the Glossary macro (where appropriate). You can learn more about the glossary macro here.

How to improve the content

Tagging standard

  • If pages are related to a given technology, they should be tagged with that technology name.
  • If pages need any type of work, a "Need*" tag should be added.

While browsing and editing MDN, you can easily link any term to the glossary by using the Glossary macro.

It takes up to three possible parameters:

  1. The term to link to (note that terms are case insensitive)
  2. An alternate text to display (an expression identical to the term, a plural version, etc.)
  3. A flag indicating if the link must be displayed as a regular link (1) or as a soft link (0, the default)
Macro Result
{{Glossary("Browser")}} Browser
{{Glossary("Browser", "Web browser")}} Web browser
{{Glossary("Browser", "Web browser", 1)}} Web browser

Writing a term definition

A term definition page must have three clear sections:

  1. A summary that shortly defines the term (one to two sentences at most)
  2. An in-depth definition that provides all the necessary details to understand what the term covers
  3. A "Learn more" section that provides various links to dig deeper in the area covered by this term

The content of a term definition must be written assuming the reader has no specific knowledge about the term and its usage. Use simple and straightforward English. Try to avoid as many technicalities as possible (it's not always possible but try to simplify).

Please remember that while gathering information from other sites is a good thing, it isn't good practice to copy and paste passages (or even entire articles) from them (otherwise we could just link to them).

For more detailed information check out the "how to write a new entry in the glossary" article.

See also