This page describes how to update MDN to match the changes that were tracked in Bugzilla bug # 761495. Sometimes the comments and descriptions in bugs are obscure and mysterious. This page attempts to provide clues and hints on how to decode a bug and find out what needs to be changed on MDN.
MDN Documentation bug tracker
The first step in addressing a bug with the "dev-doc-needed" keyword is to find a bug with the "dev-doc-needed" keyword. The MDN Doc bug tracker is a front-end to Bugzilla that makes it much easier to find bugs that require updates on MDN. Your search might have returned bug # 761495.
In Bugzilla, we see that bug # 761495 has the title: "(harmony:inthelpers) add Number.isInteger/toInteger." This suggest a couple of things:
- "Number.isInteger/toInteger": This looks like shorthand for two method names.
Scrolling through the bug comments, we eventually come to a link to the mozilla-central source-code repository:
Following the link shows the changes that were made in the source code. The description of the change ("add Number.isInteger and Number.toInteger") confirms that this is indeed a change to the
Number object, adding the
The third link in the list of changed files points to the relevant change in the source code (
jsnum.cpp). (The other two files contain test cases.)
Scrolling down, we see the actual change itself. A comment tells us which version of the ECMAScript standard implemented the change ("// ES6 draft ES6 184.108.40.206"). If we search the internet for "ecmascript harmony number isinteger" we find the descriptions of the
toInteger methods in the ECMAScript Harmony specification. This is the reference on which we can base our changes in MDN
Number object. In the Methods section of that page, we add the
toInteger methods. We note that the methods were added in version 16 of Firefox by using the "
fx_minversion_inline("16") template. (Why does the isNaN method have a page bug not the others?)
In the Firefox 16 for developers article on MDN, we note that these methods have been added to the
Now that MDN has been updated to include the changes from the bug, we will update Bugzilla so people know what changed:
- Remove the "dev-doc-needed" keyword.
- Add the "dev-doc-complete" keyword.
- Add a comment to the bug that includes links to any MDN pages that were changed.