Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Getting Started

Servo welcomes contributions from everyone. Working on a web engine can be challenging and sometimes frustrating, but it can also be very rewarding and fun. If you spend the time and effort to get involved, you will constantly be learning and growing as a developer and open source contributor. To get started, please do the following:

  1. Read the rest of this page for basic information about contributing to Servo.
  2. Successfully fetch the Servo repository and build Servo.
  3. Set up your fork of Servo and learn the basics of using Git, following the contents of our Git Setup chapter.
  4. Learn a bit of Rust. There are many resources online for how to do this, but one of the best is the official Learning Rust documentation. If you are familiar with other imperative programming languages, you can learn Rust as you work more on Servo, but having a basic familiarity with the language is very useful to get started.
  5. Set up your editor so that it integrates with rust-analyzer.
  6. Read our Style Guide for expectations about the code you contribute.
  7. Read and follow the steps for making a pull request.

Working on an issue

Should you wish to work on an issue, please leave a comment on it in order to claim the issue. This is to prevent duplicated efforts from contributors on the same issue.

Sending the message “@servo-highfive assign me” will assign the issue to you.

Head over to Servo Starters to find good tasks to start with. If you find any unfamiliar words or jargon, please check the glossary first. If there’s no matching entry, please make a pull request to add one with the content TODO so we can correct that!