Microsoft concedes to Mozilla: Redmond will point web API docs at Moz Dev Network

Firefox, IE, Chrome makers: One manual to rule them all

By Thomas Claburn in San Francisco


A few years ago, programmer and writer Bernard Meisler argued that coders write bad software because they're bad writers.

"Most engineers can't write a single coherent sentence, never mind string together a paragraph," he wrote.

So when software engineers write documentation, he reasoned, their incoherent API descriptions infect downstream code by confusing fellow programmers.

Mozilla is planning a fix of sorts. While it cannot teach everyone to write well or end the scourge of impenetrable technical specs, the maker of Firefox and the Rust programming language has teamed up with Google, Microsoft, Samsung and the W3C to consolidate and clarify the web's de facto how-to manual, otherwise known as the Mozilla Developer Network (MDN).

There are, of course, many other online resources documenting web technologies, but 12-year-old MDN – a wiki to which anyone can contribute – is one of the most widely used, visited by six million designers and developers every month.

Mozilla and its associates would like to see MDN become even more popular, by making it the one web development manual to rule them all, with the help of Microsoft and Google.

Ali Spivak, head of developer ecosystems at Mozilla, told The Register in a phone interview on Wednesday that Google, Microsoft and others have been contributing to MDN informally. A few months ago, the various parties decided to formalize the relationship through a Product Advisory Board, she said.

"One of the side benefits of a Product Advisory Board and more input from others, I hope, is that it will enable us to target our resources more effectively," said Spivak.

Y'know CSS was to kill off HTML table layout? Well, second time's a charm: Meet CSS Grid


She cited the relatively recent debut of CSS Grid support in various browsers as an instance where more coordinated communication between the various vendors might have provided better information for developers.

As a result of the tie-up, Microsoft, maker of Edge and Internet Explorer, says it's going "all-in" to support MDN as the locus of web standards docs. The Windows giant intends to redirect its API reference library to MDN.

"Developers shouldn’t have to chase down API documentation across standards bodies, browser vendors, and third parties – there should be a single, canonical source which is community-maintained and supported by all major vendors," said Erika Doyle Navara, senior content developer at Microsoft, in a blog post.

Google hasn't gone quite so far, but says it's excited to work with the group to make MDN the best, most current documentation for web devs.

MDN already scores well in surveys, topping Slashdata's recent survey in the documentation category.

"This will help us make it even better," said Spivak.

Cynics can rest assured that subpar documentation out for third-party JavaScript frameworks and libraries will continue to vex developers and support errant code for years to come. ®

Sign up to our NewsletterGet IT in your inbox daily


More from The Register

Google Play Store spews malware onto 9 million 'Droids

How did these get through the net?

FYI: Drone maker DJI's 'Get it on Google Play' website button definitely does not get the app from Google Play...

Updated Quadcopter slinger rudely palms folk off to .apk download

Latest Google+ flaw leads Chocolate Factory to shut down site early

52.5 million accounts at risk, tens of people are worried

Here you go, cloudy admins: Google emits NATty odds 'n' sods

Google Cloud Next Incremental titbits aimed at time-poor techies

Google's secret to a healthy phone? Remote-controlling your apps

Look Ma, no not much malware!

Thanksgiving brings together Apple's Siri and Google Assistant

A divided tech nation embraces, uncomfortably

Google hands out roses to preferred Android MDM vendors

Lucky few get Chocolate Factory's endorsement as Enterprise Mobility Management

Google-whisperers beat reCaptcha voice challenge with 90% success rate

Code's up on Github and Google's fine with that

Comparison sites cry foul over Google Shopping service

Original complainants say pay-to-play remedy has left them in the cold

Google: I don't know why you say Allo, I say goodbye

Sidelined messaging app given end-of-life date of March 2019