The Register® — Biting the hand that feeds IT

Feeds

Tech rivals team up for free web dev docs

Wiki site aims to be 'comprehensive and authoritative' – but don't we all?

Cloud storage: Lower cost and increase uptime

Apple, Facebook, Google, and Microsoft may seem like strange bedfellows, but the four have joined forces with six other organizations to create Web Platform Docs, a community-driven site that aims to be a one-stop shop for free web-developer documentation.

"When you want to build something for the web, it's surprisingly difficult to find out how you can implement your vision across all browsers and operating systems," writes Google product manager Alex Komoroske in a blog post announcing the site. "You often need to search across various websites and blogs to learn how certain technologies can be used."

Web Platform Docs hopes to change that by compiling the best available documentation from browser vendors, technology companies, and the Worldwide Web Consortium (W3C) in one place.

The documents now available on the site cover a wide range of subjects related to web development, ranging from tutorials to detailed reference material on HTML5 and CSS elements, JavaScript APIs, and the Document Object Model (DOM) to such novice topics as "The history of the web" and "How does the internet work?"

Currently the site describes itself as being in "alpha," but its pilot content has a strong pedigree. Redmond seeded the effort by donating some 3,200 content topics from its own Microsoft Developer Network (MSDN) archives, and several of the other founding organizations – dubbed "Web Platform Stewards" – have added their own material and will continue to do so going forward.

In addition to the aforementioned companies, the current list of Stewards includes Adobe, HP, Mozilla, Nokia, Opera, and the W3C, though the project's website says it is open to adding more.

Developers don't need to sign up as Stewards to contribute content to Web Platform Docs, however. The site is based on Wikipedia's MediaWiki platform, which allows anyone to add or edit the available content, provided they register for an account using a verifiable email address.

The site is not yet open for full community participation, but the Stewards plan to make that happen "as early as possible."

"We don't want this to come across as the giants of the web telling everyone else what to do," Opera web evangelist Chris Mills said in a statement.

The content on the site is published under various Creative Commons licenses, all of which allow the content to be copied, modified, and redistributed – the exact license for each particular document depends on its source.

That said, Web Platform Docs isn't intended to be a Wikipedia-style free for all, either. According to Opera, "While the site is a wiki, it has funding and staff on hand to monitor and maintain its content, which means that the information it contains will remain accurate and up to date."

That sounds like a bold statement to your Reg hack. In a world where one version of HTML is being maintained as "a living standard" and the other version won't be formally finished until 2014, it seems as though "accurate and up to date" information will remain a moving target for some time to come.

Still, if this diverse group of industry heavyweights is willing to collaborate, not just to draft web standards but to document and explain them as well, it can only be a good thing for web developers, whose chief tool has too often been trial and error.

"People in the web community – including browser makers, authoring tool makers, and leading edge developers and designers – have tremendous experience and practical knowledge about the web," W3C director Tim Berners-Lee said in statement. "Web Platform Docs is an ambitious project where all of us who are passionate about the web can share knowledge and help one another." ®

Customer Success Testimonial: Recovery is Everything

Maybe I'm old skool, and don't mind looking at lengthy technical specifications...

But I'm befuddled by this paragraph:

"When you want to build something for the web, it's surprisingly difficult to find out how you can implement your vision across all browsers and operating systems," writes Google product manager Alex Komoroske in a blog post announcing the site. "You often need to search across various websites and blogs to learn how certain technologies can be used."

But isn't most of what you want to discover at good ol' W3C dot org? Here's the HTML 4.01 spec (which is still current), or here's the working draft for HTML5. The documentation for CSS is available at the same place. For me, that's the first port of call for finding out what elements are available - and we're talking about standard elements, not "innovations" that work with one browser. That's how I learned how to write HTML and CSS in the first place.

Other websites are useful, and I'm not knocking them, but W3C has been invaluable to me over the years.

6
0

pointless

It seems like there is a lot of dick stroking going on there but nothing of value. I don't see anything there that says they'll work together and that IE will finally support opengl.

So it all seems like someone is just pissing money away.

3
0

Just delete w3schools.com...

... and then you won't be sending novices down the wrong track every time they want to do something new in CSS, javascript or HTML.

3
1

More from The Register

SCO vs. IBM battle resumes over ownership of Unix
Zombie lawsuit back and wants to suck the brains out of Linux
Bjarne Again: Hallelujah for C++
Plus: Now officially OK to admit you never used STL algorithms
Interwebs taunt Sir Jony over Apple eye candy makeover
Hey Ive, Ive... add more unicorns, willya?
Apple: iOS7 dayglo Barbie makeover is UNFINISHED - report
Plus: You don't like the icons? Blame marketing
Red Hat to ditch MySQL for MariaDB in RHEL 7
So long, Oracle! Don't let the door hit you on the way out
Shy? Socially inadequate? Fiddling with your phone could help
App 'tells the brutal truth' about social inadequates' chatup lines
Java EE 7 melds HTML5 with enterprise apps
New release arrives with GlassFish, NetBeans support
 breaking news
'Office Facebook' firm Tibbr wants you to PAY for mobe-meetings app
Great idea. Punters won't cough for it though
 breaking news
The only Waze is Google: Ad giant tipped to gobble map app 'for $1.3bn'
Pac-Man-satnav-ish upstart in bidding war with Apple, Facebook
 breaking news
PM Cameron calls for modern, programmable computers! (We think)
IT education musings to G8 chiefs to mystify IT industry