Networking
The Necko team is responsible for the fundamental network protocols and features like HTTP, QUIC, caching, and DNS. Most of our documentation resides on the firefox-source-docs/networking section, and our focus is to make it an accessible and easy-to-browse source of truth for our networking stack. This page serves as an extension to guide through the documentation and as a place to draft pages not yet ready to be in firefox-source-docs, but already useful on their own. At some point, all pages about networking in the wiki are intended to be lifted to firefox-source-docs.
Contents
Getting started
The general Getting started section will get you through most. Finding good first bugs in the networking component:
- Good first bug in networking component
- Good first issues in neqo - the http3 library for necko in Rust
- Most popular bugs in networking component (with at least two votes)
If you have any question, you can reach out to us via matrix at #necko:mozilla.org
Terminology
When to use Networking/Necko:
- Networking: Name of the component. Used in Bugzilla component/firefox-source-docs/wiki when describing the technical part.
- Necko: Name of the team. Used primarily in the wiki to describe the people working on the Firefox networking component.
Editing firefox-source-docs
To submit small documentation changes to the networking component, you can reference Bug 1773234 in the commit message. For example:
Bug 1773234 - Fix spelling in networking docs r=#necko
And replace the description with the actual changes done in the commit. For simple changes review is not required<ref>Managing Documentation</ref>
Code Review Policy
Patches against Mozilla's networking code must be reviewed by the module owner or a peer, or by someone they have asked to perform a specific review. To request review simply add r=#necko
to the end of the first line of your commit message.
Team resources
- Main Necko Docs page
- New to necko resources
- Testing guidlines
- Bugs in our backlog we want to look at next
Pages in the wiki
All current Networking and Necko pages in the wiki. Most of them are currently outdated and need to
- be revisited to flag as outdated
- then get updated or redirect to current documentation in firefox-source-docs