Networking: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(Add more team resources)
(Add some further information about Necko team + documentation practice)
Line 9: Line 9:


If you have any question, you can reach out to us via [[matrix]] at [https://chat.mozilla.org/#/room/#necko:mozilla.org #necko:mozilla.org ]
If you have any question, you can reach out to us via [[matrix]] at [https://chat.mozilla.org/#/room/#necko:mozilla.org #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 [https://bugzilla.mozilla.org/show_bug.cgi?id=1773234 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 message


==Code Review Policy==
==Code Review Policy==

Revision as of 15:26, 8 June 2022

The Necko (or Networking) 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:

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 message

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

Pages in the wiki

Ambox outdated.png THIS SECTION MAY BE OUTDATED
This section is in parts, or in its entirety, outdated. Hence, the information presented under it may be incorrect, and should be treated with due caution until this flag has been lifted. Help by editing the section, or discuss its contents on the talk page.

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

Necko namespace

Caches

Features

Other