You may have noticed, we recently launched a new homepage for www.webplatform.org. The recently-retired homepage was doing its job, but looking at it more closely, we realized that wanted to provide users with much more information right from the first introduction.
The new home page starts with telling the story of the project as directly as possible. What is this project? Who is involved? Why is this a great idea? What’s unique to this set of web documentation?
We made this page 100% responsive — it resizes to fit any size screen. And we moved the video so that you can play it right from this page, instead of having to click and wait for a lightbox to load before being able to watch.
The Docs List
We added a section listing the major sections of the Docs, showing which ones are ready to use, which ones are being worked on, and what ideas we have planned for the future. We hope this will make it easier for people to understand the state of the project, figure out where to jump in and help, and most of all, what documentation is already on the site, ready to use.
This list is a work in progress. The plan is to continuously update it with new links, and move links from column to column as the status of things change. People should be able to come to this list to quickly see exactly what’s on the site.
As I’ve gotten involved with Web Platform Docs, and dug into researching what’s going on, I’ve found that there’s a lot of great stuff going on that people just don’t know about. It’s my goal to make it much easier to find such treasures, and this section is a start.
The lower part of the page is dedicated to explaining exactly how to get involved. Rather than asking people to read many pages in the Editor’s Guide, we wanted to put the most important information right up front where it’s easy to find and follow.
I’ll be overhauling the Editor’s Guide, likely renaming it Contributor’s Guide next, to reflect what I’ve discovered about how to get involved, and to better match the message that’s now on the home page. Since Web Platform Docs is relying heavily on the contributions of volunteers to update and improve the documents that have been imported from MSDN, we need people to be able to join the effort with as little friction or confusion as possible.
A new platform
Lastly, we also changed the technology that’s driving this and other pages on the www.webplatform.org domain. Most of the Web Platform website is handled by MediaWiki hosted at docs.webplatform.org, while this blog is driven by WordPress at blog.webplatform.org. The home page, along with several other static HTML pages, are hosted separately at www.webplatform.org. These were hand-coded pages that used a bit of php includes to handle the header and footer.
This is just one more step in improving the Web Platform project. We will keep improving both the design and content of this homepage, bit by bit. Let us know if you have any suggestions or ideas for how to keep improving things.