JavaScript documentation status

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

Summary

Pages No tags Needs* tags Missing tags Editorial reviews Technical reviews Outdated pages Dev-doc-needed bugs Documentation requests
872 0 (0%) 0 (0%) 0 (0%) 12 (2%) 17 (2%) 87 (10%) 0 (0%) 42 (5%)

See also localization status of this section.

Editorial reviews

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

Technical reviews

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

Outdated pages

Found 87 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.

Documentation requests

Found 42 bugs. Documentation request bugs can contain various kinds work related to MDN pages. Read through the bug and ask questions in the bug if in doubt.

Bug Summary
1179881 Write a JS error reference
1201380 Examples and text don't match up in "details of the object model" page
1204224 Unclear explanation in "Working With Objects" tutorial
1243496 The function declaration and function expression documentation is incorrect
1245977 MathML fallback: square root is not displayed correctly
1275816 Explain how |this| value is calculated in call expression, and the difference between `foo[prop]()` and `func = foo[prop], func()`
1281696 iterating with let in for-loops
1286628 Object.prototype.constructor is not a reference to the constructor of the prototype
1294338 charCodeAt and codePointAt in String documentation seem almost backwards
1301501 polyfill uses != to check typeof assign to "function" vs !==
1303603 Clarify that RegExp.prototype.exec() returns a special array
1305261 Async Functions/Await Documentation
1307755 Given for..of example needs some explanation, not self-explaining
1309784 Add Cyclomatic Complexity
1318620 Slightly misleading example
1318933 Description of `Object.keys` outdated because it does not return symbol keys
1319979 Equality comparisons
1322844 Tagged template literals example does not illustrate point being made
1323323 Supercharging our example website contains example that does not work in the Chrome Browser
1324194 Incorrect description for example summary found on array.prototype.filter() page (JSON example)
1325251 The Math.sign() polyfill contains two type conversions
1334000 Polyfill example does not detect NaN
1336740 Create page: TypedObject
1340310 How does the Cache interface handle cookies?
1343142 Clarify that Array.prototype.sort() sorts in increasing order
1346500 The result of the polyfill doesn't meet the result of firefox.
1347496 Inaccurate information in a code snippet
1352856 continue statement, example 2.
1357343 Console.table example does not work as expected
1359860 Make /W special character regex more clear
1360102 About the global property with "var" in MDN.
1360250 mac.id is 5 in 'Global information in constructors' example
1360661 Document for Array.from provides a polyfill that cannot create array from a Set
1361299 mixin replace jQuery.extend with Object.assign
1363684 tip faster js offsetwith
1365288 Map.get/set documentation is lacking information
1367757 Should String.prototype.substr be marked as deprecated?
1371716 Syntax example provided is incomplete / incorrect
1372019 Filter the javascript docs on ES version support
1372390 Promise.all returns already-resolved promises for any combination of non-promises and resolved promises.
1374016 A consistency issue: different parts of MDN have links where in other parts they're buttons
1376223 "Promise" Advance Example CodePen Has a Bug

Browse as bug list.

Localizations

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

Language Pages Translated Translations up to date
af 804 0 (0%) 0 (0%)
bn-BD 804 32 (3%) 0 (0%)
ca 804 320 (39%) 9 (2%)
de 804 355 (44%) 243 (68%)
es 804 312 (38%) 37 (11%)
fa 804 9 (1%) 1 (11%)
fr 872 872 (100%) 871 (99%)
id 804 82 (10%) 20 (24%)
it 804 77 (9%) 7 (9%)
ja 870 821 (94%) 156 (19%)
kab 859 1 (0%) 0 (0%)
ko 804 264 (32%) 102 (38%)
nl 813 42 (5%) 6 (14%)
pl 804 261 (32%) 4 (1%)
pt-BR 804 256 (31%) 47 (18%)
pt-PT 804 30 (3%) 3 (10%)
ro 804 14 (1%) 0 (0%)
ru 859 518 (60%) 53 (10%)
zh-CN 869 692 (79%) 235 (33%)

Structure of the MDN JavaScript docs

Chapters of the MDN JavaScript section and their status
# Chapter Pages Priority Notes
0 Value & function properties in the global scope 16 1 Complete.
1 Object 40 1

Complete.

2 Function 14 1 Complete.
3 Array 38 1 Complete.
4 String 50 1 Complete.
5 Boolean 5 1 Complete.
6 Number 24 1

Complete.

7 Math 44 1 Complete.
8 Date 53 1 Complete.
9 RegExp 21 1 Complete.
10

Error
EvalError
InternalError
RangeError
ReferenceError
SyntaxError
TypeError
URIError

24 4 Complete.
11 JSON 3 1 Complete.
12 Intl
Intl.Collator
Intl.DateTimeFormat
Intl.NumberFormat
16 2 Complete.
13 Map 13 2 Complete.
14 WeakMap 7 2 Complete.
15 Set 11 2 Complete.
16 SIMD

Float32x4
Float64x2
Int8x16
Int16x8
Int32x4
Uint8x16
Uint16x8
Uint32x4
Bool8x16
Bool16x8
Bool32x4
Bool64x2
SIMD types

  3 In Nightly. Spec in flux.
17 WeakSet 6 2 Complete.
18 Proxy 17 3 Complete.
19 Reflect 15 3 Complete.
20 Generator (legacy and ES2015)
Iterator
StopIteration
GeneratorFunction
8 2 Complete.
21 ArrayBuffer (6)
DataView (21)
TypedArray (34 [+ 3])
Float32Array
Float64Array
Int16Array
Int32Array
Int8Array
Uint16Array
Uint32Array
Uint8Array
Uint8ClampedArray
73 2 Missing pages:
  • 2 standard Array methods not yet implemented for TypedArrays (tracking bug 1071668).
22 Promise 8 1 Complete.
23 Symbol 9 2

Missing pages:

  • Well-known symbols
    • Symbol.hasInstance
    • Symbol.isConcatSpreadable
    • Symbol.replace
    • Symbol.search
    • Symbol.split
    • Symbol.unscopables
24 ParallelArray 1 5 Complete.
25 Atomics
SharedArrayBuffer
17 4 Preffed off. Spec in flux.
26 Expressions & Operators 29 1 Complete.
27 Statements & Declarations 27 1 Complete.
28 Functions 11 1

Complete.

29 Classes 4 1 Complete.
30 JavaScript Guide 15 1

 

  1. Introduction
  2. Grammar and types
  3. Control flow and error handling
  4. Loops and iteration
  5. Functions
  6. Expressions and operators
  7. Numbers and dates
  8. Text formatting
  9. Regular Expressions
  10. Indexed collections
  11. Keyed collections
  12. Working with objects
  13. Details of the object model
  14. Iterators and generators
  15. Meta programming
31 New in JavaScript 15 4

Complete.

32 JavaScript error reference 36 3 Explains error messages (v8, Chakra). So that people searching for errors will find guidance.
33 Articles/Tutorials/Misc 17
 
3
34 Meta pages 9 4

Other tasks to do

  • Go through Firefox release notes for developers and site compat notes and make sure JS changes are documented properly in the references.
  • Make sure our compat tables are up to date by also going trough bug trackers of other open source browsers (e.g. WebKit, Blink)
  • Write a changelog for Chrome JavaScript releases like we have for Firefox. Same for other browsers/node.js?
  • Meta article about how to document in the JS MDN area.

Tagging standard

  • Pages in the JavaScript/ page tree should at least have the tag "JavaScript".
  • For methods belonging to an object, the name of the Object should be added (e.g. String.fromCharCode should have "String").
  • Methods should have "Method" and properties need a "Property" tag. All prototype members have the "prototype" tag.
  • Features added in a new ECMAScript version have the tags "ECMAScript6" and "ECMAScript 2015" or later versions/years.
  • The Experimental tag should only be used with new features where the standard in not yet finalized (e.g. in a strawman proposal) and the feature is in a Nightly version or behind a preference.
  • Features are Deprecated if their usage is discouraged and are Obsolete if they have been removed from engines.
  • If pages need any type of work, a "Needs*" tag should be added (see above).

Specifications

The following specifications are taken under consideration for this project:

Specification Status
ECMAScript 5.1 (ECMA-262) Standard
ECMAScript 2015 (6th Edition, ECMA-262) Standard
ECMAScript Latest Draft (ECMA-262) Living Standard
ECMAScript Internationalization API 1.0 (ECMA-402) Standard
ECMAScript Internationalization API 2.0 (ECMA-402) Standard
ECMAScript Internationalization API 4.0 (ECMA-402) Draft
Proposals (with advanced stage and at least 1 implementation) Draft

Help the 'JavaScript' documentation project…
Topic driver : Florian Scholz (IRC nickname: fscholz)
Look at the current status of the 'JavaScript' documentation.
Don't hesitate to contact us on #mdn or on the MDN discourse group/list:

Document Tags and Contributors

 Last updated by: fscholz,