MSDN Web Platform Documentation Now Mapped to Mozilla Developer Network
Last week the Microsoft Edge team followed through with an announcement they made at last month's developer summit by mapping the MSDN web platform documentation to Mozilla's MDN. In addition to applying 301 redirects from MSDN Microsoft's web platform documentation team will start editing MDN resources.
Microsoft is not alone in this effort. They are being joined by Google Chrome, Samsung Internet, Mozilla and the W3C. This means there is a combined effort by major browser vendors to produce the best, canonical documentation for developer reference.
Representatives from each organization are joining the MDN Product Advisory Board. This means the Mozilla repository should serve as a the goto place for unbiased standards-based documentation for web technologies.
The board is not limited to members from these companies. They are actively seeking community members. You can find out more about joining the board on the MDN documentation site.
Microsoft alone is mapping over 7700 documents. Personally I would love to to know how they organized the 301 redirecting project.
7700 is a significant number of documents. If you think about that the typical developer book is between 200-400 pages. Occasionally you encounter a much larger tome, but rarely. I know what it takes to write developer books of these lengths and it is no small feat.
The MDN site is used by over 6 million each month and has 20,500 contributors. It currently houses over 34,500 documents, almost 5 times as many documents as MSDN is mapping.
For Microsoft specific web platform documentation, like Edge developer tools, they will continue to maintain documentation on MSDN.
My hope is this combined effort will lead to better documentation with more complete examples. I find the documentation to be lacking in some areas, especially when I am playing with very raw technology or rarely used APIs.