JavaScript reference docs land on WPD

The goals of webplatform.org are bold, its projects large and ambitious. As have many other volunteers before me, I caught a sense of that vision and decided to make it my own while working on a particular ambitious project: documenting JavaScript on Web Platform Docs.

I’m happy to say we’ve just completed a major milestone in documenting JavaScript on WPD. The first part of the project was to take JavaScript reference material donated by Microsoft and reformat and import it into Web Platform Docs, fitting it into templates and forms to make the content match the WPD structure.

I took charge of detailing the structure of the page content, and importing, normalizing, and converting the original HTML into wikitext, while in parallel Eliezer Bernart created the Semantic MediaWiki templates for each page. Eliezer started out knowing nothing about Semantic MediaWiki, but with enthusiasm and skill quickly learned how to build the templates and worked closely with me to create the framework to hold the content in a structured way. This kind of teamwork across nations and continents (Eliezer in Brazil, and me in North Carolina, USA) is what makes a project like this special.

Building a dream, making real what you have envisioned, and materializing ideas ultimately comes down to sharing your dream with people who will build with you, who are willing to take a series of smaller steps as their own. Though the contributors at WPD are divided across various projects, locations, and teams, we work under just enough guidance to aim in the same general direction. Your dream becomes the larger dream, and those smaller steps feel lighter and less difficult to the person fueled by a sense of accomplishment passing milestones of completion towards the building of what they deem good and useful.

Along with this dream came inevitable disagreements, volunteers whose hours don’t always coincide, people who have to go away a few weeks on another project before coming back to help, and other pesky irritations that are really the human backdrop every team has to face. It’s the nature of collaboration.

But this dream also meant making new friends: two people each driving halfway across a state to meet up and discuss the project, working with others who excel in their own area, feeling you are part of something bigger than yourself. Some contributors and colleagues to be called out by name include Doug Schepers, Eliezer Bernart, Eliot Graff, Julee Burdekin, Rick Byers, Rick Waldron, and Renoir Boulanger. I thank each person and am glad to have met you!

What this initial JavaScript import means is integrity and reliability of information, ongoing relevance as that information changes, and designers to improve its usability. Webplatform.org is not just another site, it’s a plan to building resources for a better web. This first phase created an initial corpus. We’ll follow this with additional work to attach additional semantic data, add topic clustering, generate automatic subpage listings, and best of all, enforce cross-checking with and cross-referencing to original ECMAScript standards. Keep checking this blog for announcements about how you can help with all this. Come catch the dream.