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

Posted in Software, 18th October 2017 20:10 GMT

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

READ MORE

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

19 Comments

More from The Register

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

Heart Of Gold meets Piece Of Crap

Scammers use Google Maps to skirt link-shortener crackdown

Chocolate Factory's map service cuts commute times, URL lengths

Google borg gobbles Israeli cloud migration startup

Alas poor Velostrata! You knew those AWS and Azure workloads well

'Don't Google Google, Googling Google is wrong', says Google

Chocolate Factory unwraps developer style guide, squibs the thorny ISO date debate

Android devs prepare to hit pause on ads amid Google GDPR chaos

Hey Google. How will we eat?

Dropbox to let Google reach inside it and rummage about

Create and store GDocs in Dropbox, with admin policies preserved

US judges say you can Google Google, but you can't google Google

The Chocolate Factory is spared the aspirin treatment by the 9th Circuit Court

Twitter signs for Google cloud at list price of about $10m a month

Shifts Hadoop clusters and their 300PB of data, not the stuff that lets you tweet

Apple: Er, yes. Your iCloud stuff is now on Google's servers, too

You can't escape The Circle

Oracle tells tales about Google data slurps to Australian regulator

At an inquiry into news and ads, of all things. Is Big Red playing a deeper game?