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.

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

1. be revisited to flag as outdated
2. then get updated or redirect to current documentation in firefox-source-docs

Networking

Necko

Other

• PSM: Platform Security Module
• Glossary
• Finding first bugs
• Collection of tools by Necko
  • Necko Triage Helper[1]
  • logan - Introduction
  • Who's triaging
• Past meeting notes from 2018-12-13 to 2020-08-19
• Past meeting notes from 2015-11-06 to 2018-12-05