To address part of this issue, we’re starting a new and free guidebook called the Web Platform Contribution Guide. We’re hoping this guidebook can be one piece of a support system that helps our industry address the systemic exclusion of people with marginalized backgrounds from participating in web standards. We know this is not a complete plan. We also need long-term funding for folks that are currently excluded to learn to contribute and get involved. We see the Web Platform Contribution Guide as a first step while we seek broader change in our community and culture.
The Web Platform Contribution Guide is a guidebook about how we contribute to developing the web platform. With this guide, we hope to help onboard readers into the process of fixing inconsistencies between web browsers and participating in the process of improving interoperability on the web platform. It doesn’t take a computer science degree, or deep engineering know-how to get started (though those don’t hurt). A lot of this work is about spending time in the details, documenting what’s wrong, and building consensus about the solution. As we say in the guide:
In the context of this guide, the goal of working on the web platform is to reach interoperability, not to add features, or change specs. This is maintenance work, and it is the one of the most important things that the web needs.
Who is this guide written for?
Have you worked on or used a web site or web app and found a difference in behavior between two browsers for the same markup or CSS, but don’t know how to get the underlying problem fixed? Have you ever wanted to be able to spot a bug in a web standard specification? Or wanted to know how long it takes before web standards and all implementations agree? This guide is for you.
How did this get started?
It all started in 2018 when everyone at Bocoup spent a day collaborating on web-platform-tests (WPT). Some of us have been working on WPT for many years, but it was a first-time contribution for many members of the team. This was a lot of fun, and it moved the web forward! Among other things, we reformatted some tests so that they could be run both by browsers and also by Node.js.
Based on this experience, we started to write this guide.
What does the guide cover?
The guide covers a range of topics from the high-level process and the organizations involved, to what skills you might use, along with detailed how-to sections, and interviews about career paths from people working in web standards:
- How the web platform is governed: which standards bodies and working groups govern different web technologies.
- How intellectual property is managed at the W3C and the WHATWG.
- What skills are often used in standards development, including a primer on how to read and write web specifications.
- How to fix a W3C or WHATWG bug, from deciding what to work on, how to figure out how to fix it, to reporting browser bugs.
- Paths for growth: what are the opportunities for building a career?
- Case studies: specific examples of web platform bugs and how they were fixed.
- Interviews: individual stories about folks who contribute to the web platform and how they got started.
- How to find who to talk to, in particular within browser engine projects.
- Finally, a glossary; terms throughout the guide are linked to the glossary.
How can you help?
If you work for an organization that implements a web standard and is interested in funding beginners from marginalized backgrounds to learn and contribute, we’d also love to collaborate on that.