This page tries to track ongoing documentation work for MDN QA docs. Feel free to contribute!

Summary

Pages No tags Needs* tags Missing tags Editorial reviews Technical reviews Outdated pages Dev-doc-needed bugs Documentation requests Missing pages
106 24 (23%) 6 (6%) 0 (0%) 2 (2%) 5 (5%) 77 (73%) 0 (0%) 151 (143%) 26 (25%)

See also localization status of this section.

No tags

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

Needs* tags

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

Editorial reviews

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

Technical reviews

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

Outdated pages

Found 77 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 151 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
783855 Migrated image/attachment all need a REDIRECT to be fetched
855636 Show footer with all versions on "Firefox <XX> for developers"-pages
950811 The 'Event Guide' needs a high level organization
952807 Too many tags linked to no articles
960944 Remove or relicense pages from 'Creating XPCOM components'
1081114 Document best practices for login forms
1119251 Accessibility: External links
1188838 Add JSON template for DOM events
1189700 Better beginner's documentation for CORS
1195781 Document 'distributed node' in the Glossary
1202694 Change cookie library on https://developer.mozilla.org/en-US/docs/Web/API/document/cookie
1208816 Document XPathResult
1212760 Use .properties for the event summary tables
1224966 Code on developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/deriveKey will not run, has many bugs
1231694 Complete documentation for RTCIceCandidate
1231772 embedLiveSamples that need attention
1245319 404 Videotrack.sourceBuffer and Texttrack.sourceBuffer
1250768 Document NonElementParentNode DOM mixin
1254181 Document RTCOfferOptions
1259002 Navigation side bar on mdn does not exist in zh-CN but exists in en-US
1270376 `server-sent events` page not in Web APIs list.
1287617 Don't link to obsolete specs
1289971 HTMLCommandElement document link is not existed
1296830 The documentation for XHR overrideMimeType shows info for Request instead.
1298724 Bug in StringView code
1301998 Specifying security concerns for targetOrigin of postMessage
1303641 Documentation links broken - characterdata
1308164 Bug reporting link does not work
1314652 Create a tool for cross-version Firefox code search and compare
1315191 searchParams is available at least from Firefox 49
1318850 missing page link in Client-side_web_APIs/Introduction
1320955 Advanced Network Communication Section Not Found.
1322820 Bit masks in WebGL documentation
1322823 Template:KeyboardEventProperties seems outdated and incorrect
1328799 revise <dialog> page: Specifications table
1332938 list of dependency versions linked to in release documentation would be nice
1333751 Intent to delete: Connect pages
1335579 Broken link 'composedPath()' in documentation (or missing documentation).
1337332 Fully document the History API
1339914 Error: WebGL: texImage2D: Conversion requires pixel reformattin
1340062 I translte https://developer.mozilla.org/en-US/Add-ons/AMO/Policy/Agreement and translte “Agreement ” to “协议”
1342055 mising example prototype
1342609 Documentation Q: Description section, paragraph 2 might want to mention Maps
1343145 Clarify attribute checked for <input type="checkbox">
1344254 Create a series of articles introducing media on the Web
1345026 Incorrect/not full information on the location of Eyedropper button
1347159 Window.restore() doc says not working, but works for me?
1349550 It is really true that 405 can't be used for GET or HEAD?
1351137 all DataView methods need parameter documentation
1352109 404 when accessing the https://developer.mozilla.org/en-US/docs/Web/API/SVGFEConvolveMatrixElement
1353757 A confusing explanation of a code snippet
1358768 ARIA techniques article split up or combination
1358933 Image in article provides pointer labels in French
1360820 A code example missing
1364757 HttpOnly documentation explanation ambiguity
1366867 Mobile cross-browser subset of HTML/CSS
1367037 `thing` does not exist
1368043 Correcting Browser Console in Portuguese Language
1370109 Reference trail from the note re Safari on the :hover article
1372074 Strict rules for JavaScript snippets.
1372493 Outdated link to CSS Backgrounds and Borders Module Level 3
1372609 Intersection Observer page auto-scrolls to embedded iframe on load
1382160 Typo in image about caching
1386720 "For sideloading" & "For desktop apps" & "For an enterprise" links under "Distributing add-ons" are broken
1387131 "Web technology reference" page is incomplete
1389025 Editorial review for typos and grammar on Web_Crypto_API
1389431 current content needs to be reseted back to english version
1391059 some CORS examples are inaccurate
1394177 Number Guessing Game
1394870 Object.entries change
1399054 Documentation needs KeyboardEvent.key footnote regarding support on Android (KeyboardEvent.key support is broken)
1400210 Mistake in the Introduction of "Memory Management" chapter
1404580 Document connect event
1405347 Fully document SVGMatrix and DOMMatrix
1405398 Add `SSL` to MDN Glossary
1406013 Broken link/missing page for FileReader/FileReader constructor
1407191 Event loop message queue processing: incorrect description
1407340 Write glossary entry for "Cache"
1409246 Service Worker introduction talks a lot about AppCache.
1409952 Fully document 'FontFace'
1410019 Suggested implicit call of 'Date.parse' method is incorrect
1410675 Docs say `delete` on a non-configurable property raises a SyntaxError in strict mode.
1410743 Open page "https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/Channels" shows "You're trying to create a new page."
1413456 Concept of "Hoisting"
1416300 Event documentation is missing from iframe
1418428 some function are no longer supported
1418612 note about "pagination" / ordering could be better placed elsewhere
1423858 Description of SEC_ERROR_EXTENSION_VALUE_INVALID is misleading
1425646 Lacking width attribute in <textarea> element in Active learning examples at CodePen and JSFiddle
1425649 "Show solution" button in Active learning examples should toggle displaying of the solution code while preserving user edits
1430943 Missing definition for NotificationAction
1432382 sidebar links of document looked like broken (in other language)
1432546 unclear example
1433067 Create page: https://developer.mozilla.org/en-US/docs/Learn/Drafts/Python_on_the_client
1433069 Create page: Create page: https://developer.mozilla.org/en-US/docs/Learn/Drafts/Python_on_the_client/Accessing_the_DOM
1433071 Create page: Create page: https://developer.mozilla.org/en-US/docs/Learn/Drafts/Python_on_the_client/Using_JavaScript_libraries
1433072 Create page: https://developer.mozilla.org/en-US/docs/Learn/Drafts/Python_on_the_client/Sharing_code_between_client_and_server
1433152 Specification dead links
1433904 Broken link on https://developer.mozilla.org/en-US/docs/Web/API/SVGSVGElement
1438381 Update API overview page to fix broken links
1440273 accesskey does not work as described
1440860 [MDN] Some nav links in web components broken
1441696 express tutorial escaping text twice
1442015 Add glossary entry for the term "stylesheet"
1448217 DataTransfer.dropEffect example does not work on chrome, but the compatiblity tables at the bottoms says it should
1449109 Update translation of https://developer.mozilla.org/es/docs/Web/HTML/Elemento/tr
1449146 Add glossary entry for the term "Worker"
1456808 Mistake made in the "position absolute" part
1456943 document canvas dimension limits
1457502 Web Components Main Link Leads to 404
1459030 Please move the JavaScript Demo lower on the page
1459816 Annotation error
1460485 Document History.replaceState
1460916 MDN needs a GDPR page for web developers
1461232 New webpage
1461599 Broken links https://developer.mozilla.org/de/docs/Web/Barrierefreiheit/An_overview_of_accessible_web_applications_and_widgets
1462298 "Article navigation" is broken on our Code Style MDN entry
1462849 app does not work
1465598 Error in Translation of MDN
1465722 Doc does not mention passing an options object
1470139 Document browser quotas for Web Storage APIs
1470912 Many of the links on "Guide to Web APIs" lead to a new blank page
1471715 Typo on What_is_JavaScript: двайте should be давайте
1472229 404 for https://developer.mozilla.org/en-GB/docs/Tools/Network_Monitor
1473016 MDN: "Función async" linked to an none existing page
1473252 order of keys in an Object
1473590 const definition incorrect
1475056 Web/Guide/Performance needs content
1475839 Cannot find any working lightning xpi
1475851 OS-specific XUL access key attribute documentation wrong
1476558 Update MDN Docs for Navigation Timing Level 2 spec
1476704 Behavior of window.history.back and browser back button not identical.
1477269 Thunderbird : List message in folder
1479003 Document the consideration for using browser-style = true in a web extension
1480867 Headers method foreach link not found
1485050 Decide upon and implement changes to GroupData to support dictionaries, types, etc
1485522 Consider removing the third ("Comments") column from the specification tables
1490090 MDN Docs: Make Experimental features in Firefox more legible
1490655 Add concept/explainer and glossary docs for visual viewport
1491304 wiki.mozilla.org and trr mozilla.cloudflare-dns.com
1492061 中文文档:”Function构造器生成的函数,在全局作用域中被创建中“的例子出错
1492281 This talk page is higher in the DDG search results than the page its about
1492337 broken links on /...Web/API/FileReader page
1492765 Simple Seamonkey build instructions outdated
1493378 responsive design view unavailable
1493556 Broken link in "Helping the Graphics Team" page
1495202 I do not care about cookies
1495289 Language setting is never saved
1495957 https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/Dealing_with_files
1496431 MDN docs/Tools/GCLI: Incorrect note/warning for Developer Toolbar function replacements
1496482 The MDN home page doesn't have single pagedness in mobile

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 108 0 (0%) 0 (0%)
bn-BD 108 3 (2%) 1 (33%)
de 108 2 (1%) 0 (0%)
es 108 7 (6%) 1 (14%)
fa 108 0 (0%) 0 (0%)
fr 108 5 (4%) 1 (20%)
it 108 3 (2%) 1 (33%)
ja 108 13 (12%) 0 (0%)
ko 108 2 (1%) 0 (0%)
pl 108 2 (1%) 0 (0%)
pt-BR 108 4 (3%) 1 (25%)
pt-PT 108 1 (0%) 1 (100%)
ro 108 1 (0%) 0 (0%)
ru 108 6 (5%) 1 (16%)
zh-CN 108 4 (3%) 0 (0%)
zh-TW 108 2 (1%) 1 (50%)

General plan for QA docs

Mozilla has lots of QA documentation available: QMO, Main MDN QA landing page, Firefox OS automated testing landing page, and more. We ought to streamline our QA content by weeding out the obsolete stuff, updating the out of date stuff, and turning the different resources into a more cohesive resource.

Team

  • Chris Mills: MDN editor
  • Marcia Knous: Main QA contact

Join the project

MDN is built by you, the reader! If you'd like to help make this documentation real, we'd like to hear from you. You may contact the writing team by clicking on their names above, or on our mailing list. If you're a new MDN contributor, please have a look at our contributor guide. You can also join the conversation in our IRC channel #mdn.

Goals

Audit our current QA content

  • Write a plan for reorganizing it into a more cohesive resource that lives on MDN.
  • Migrate the non MDN content over to MDN.
  • Update and reorganize the existing material on MDN.
  • Make it easier for QA staff and volunteers to help perform QA work.

Target milestones

TBD: This work is not super urgent, but it would be nice to do it soon.

Note: Each milestone bug should block bug 1054344, which is a tracking/meta bug for this project.

User stories

  • I want to write tests for Mozilla products
  • I want to Help perform QA/testing work on Mozilla products
  • I want to find out what tools I need to use to do QA work, what workflow I'd use, and how to get started.
  • If I want to help with testing of Firefox, Firefox OS, or other Mozilla projects, where do I find out what needs to be tested?

Documents needed

Mainly reference and guide documents. This is mainly TBD. This can be done after the audit of existing docs.

Existing documents

Notes

The following items were discussed in a meeting between Chris Mills and the QA staff.

What should be kept where, on MDN?

Should we keep everything under a top level QA node, or should that node just contain generic stuff like introduction, how QA works at Moz, what all the tools are, how to get involved in the community, call to action, etc.? We could then put more applied Firefox / Firefox OS - specific stuff in the relevant zones and link to those from the main QA node. I think this latter idea is better for organization, as people are more like to think product first, then QA, rather than QA first, then product, although both camps do probably exist. This would allow us to cover both.

What should be moved over from QMO?

This is up for discussion. The content (on both MDN and QMO) needs to be audited to work out what stuff should be kept, and what stuff can be dumped due to being out of date or dupe.

There was also the question of whether the community / call to action stuff should remain on QMO, but the actual content should go on MDN, as QMO already has a bit of a following/page rank

I (Chris) personally think everything should just go on MDN, as MDN's page ranking will be higher, and it's good to have everything in one place and not fragmented. Plus if it is on MDN, it is all under the remit of the MDN editors, so we can maintain it.

Tips and tricks (for example B2G tips and tricks and QA tips and tricks) should go somewhere sensible as well.

Should QA be a zone?

I think so. I think QA falls under the zone definition, in that it is a specific function, product or action.

Next steps

  1. QA team to audit existing material.
  2. Chris Mills to work out where to put all the material, and draw up plan for content strategy

See also

This QMO Etherpad for further discussion/raw notes.

Document Tags and Contributors

Contributors to this page: wbamberg, fscholz, jswisher, chrisdavidmills
Last updated by: wbamberg,