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

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

Google Cloud Next Incremental titbits aimed at time-poor techies

Surprising no one, Google to appeal against European Commission's €4.34bn Android fine

We'll just take our time here

Google now minus Google Plus: Social mini-network faces axe in data leak bug drama

Project Zero would have been all over this – yet it remained under wraps

Iron Mike Pence blasts Google for its censor-happy Dragonfly Chinese search engine

Wait until the Veep finds out what Apple is doing for them

Neil Young slams Google, after you log in to read his rant with Google or Facebook

Heart Of Gold meets Piece Of Crap

Nutanix shares briefly wobble over Google server appliance fears

What if someone else owns someone else's computer?

No do-overs! Appeals court won’t hear $8.8bn Oracle v Google rehash

Only thing left now is a Supreme Court bid in row over Android and Java copyright

Google shaves half a gig off Android Poundland Edition

Always believe in Go ...

Google to build private trans-Atlantic cable from US to France

Bandwidth is better, down where it's wetter, take it from me!

Cookie clutter: Chrome saves Google cookies from cookie jar purges

Privacy bod says 'remove all' function not living up to its name – netizens stay logged into Chocolate Factory