So, this is where you come in!
Help us transform the MSDN donation into WPD content
We converted that spreadsheet file to a JSON object, and used Node.js to rename all the files (e.g. “getMilliseconds-Method__Date.html”) and convert the XML hierarchy index to an HTML nested list to serve as a table of contents, then pushed everything to WebPlatform’s Github msdn-js repo.
So, there’s where we are. Where we go next is up to the community as a whole, because Webplatform is a community-based and community-driven project. Microsoft donated the source content, but it will be the community that takes this donation and builds WPD with it. And let’s face it, content integration is not a trivial task. It’s not difficult, either, but there are lots of moving parts.
- First, we have to settle what on the URL structure. How do we want to organize the different pages within our information hierarchy, so that it’s consistent, easy to find and reference, and avoids naming clashes?
- Second, we have to make MediaWiki templates. We need to define how each page type (object, property, method, etc.) is structured, again for consistency and to make it easy for an API to extract just the information needed.
- Third, we have to come up with a methodology to convert the HTML content into the wiki. Converting 400+ pages by hand would be tedious, but an automated import script is likely to be error-prone, even with consistent and well-structured HTML like the export from MSDN. Which sections do we use? What do we do if we need to add structure that doesn’t exist in the original? How shall we review all the converted documents? Should we import first into our test wiki instance, then transfer into the main wiki? In some cases, there may be duplicates of content already in the wiki; how shall we resolve that? What import script should we use (and can we revise and reuse the script from our original MSDN mass-import back in October)? Phew!
What can I do?
For starters, you can help us answer these questions, and ask questions we didn’t think about. If you don’t already have an account, go create one, and feel free to participate in one or more of our general content meetings. You can volunteer to help do the conversion, review migrated content, or help out with other parts of the project. All our work is public, and to help manage this process, we created a special sub-project, MSDN-JS, in our issue tracker/project management tool. Once you have an account, subscribe to our public-webplatform mailing list and introduce yourself, and we’ll help get you started.
Don’t feel intimidated by all these open questions! We’ve already got a skilled community, like Alex Komoroske (Google) who authored most of the site templates, Eliot Graff (Microsoft) who helped design WPD’s information architecture, and content drivers like Chris Mills (Opera and W3C), Julee Burdekin (Adobe), and Scott Rowe (Google), as well as many other folks who can lead the integration… or step aside to let new leaders take the initiative!
What about other donations?
We’ve gotten this type of donation before. We’ve received large transfers of content files from nearly all of our stewards. To cite a few examples, Google and MDN have donated many articles and tutorials; Opera donated a great deal of their developer education materials; Adobe offered wonderful content from their site; and Microsoft had donated reference pages previously. It’s been a wonderful and cooperative effort to get the seed content in place for this project.
You really need me?
Yes. Even with big content contributions like this one from Microsoft, this site will never succeed in our mission without consistent contributions and engagement from our community. So, consider your effort in integrating these documents a “matching donation” and help us make WPD the documentation site we all need.