security/nss/doc/rst/community.rst

   1 .. _mozilla_projects_nss_community:
   2
   3 Community
   4 ---------
   5
   6 Network Security Services (NSS) is maintained by a group of engineers and researchers,
   7 mainly RedHat and Mozilla.
   8
   9 .. warning::
  10
  11    While the NSS team focuses mainly on supporting platforms and features needded by
  12    Firefox and RHEL, we are happy to take contributions.
  13
  14 Contributors can reach out the the core team and follow NSS related news through the
  15 following mailing list, Google group and Element/Matrix channel:
  16
  17 .. note::
  18
  19    Mailing list: `https://groups.google.com/a/mozilla.org/g/dev-tech-crypto <https://groups.google.com/a/mozilla.org/g/dev-tech-crypto>`__
  20
  21    Matrix/Element: `https://app.element.io/#/room/#nss:mozilla.org <https://app.element.io/#/room/#nss:mozilla.org>`__
  22
  23 ..
  24    -  View Mozilla Security forums...
  25
  26    -  `Mailing list <https://lists.mozilla.org/listinfo/dev-security>`__
  27    -  `Newsgroup <http://groups.google.com/group/mozilla.dev.security>`__
  28    -  `RSS feed <http://groups.google.com/group/mozilla.dev.security/feeds>`__
  29
  30 .. _how_to_contribute:
  31
  32 `How to Contribute <#how_to_contribute>`__
  33 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  34
  35 .. container::
  36
  37    Start by opening a **Bugzilla** account at `bugzilla.mozilla.org <https://bugzilla.mozilla.org/>`__ if you don't have one.
  38
  39    ``NSS :: Libraries`` is the component for issues you'd like to work on.
  40    We maintain a list of `NSS bugs marked with a keyword "good-first-bug" <https://bugzilla.mozilla.org/buglist.cgi?keywords=good-first-bug%2C%20&keywords_type=allwords&classification=Components&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&component=Libraries&product=NSS>`__.
  41
  42 .. _creating_your_patch:
  43
  44 `Creating your Patch <#creating_your_patch>`__
  45 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  46
  47 .. container::
  48
  49    See our section on :ref:`mozilla_projects_nss_nss_sources_building_testing` to get started
  50    making your patch. When you're satisfied with it, you'll need code review.
  51
  52 .. _code_review:
  53
  54 `Code Review <#code_review>`__
  55 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  56
  57 .. container::
  58
  59    `http://phabricator.services.mozilla.com/ <https://phabricator.services.mozilla.com>`__ is our
  60    code review tool, which uses your Bugzilla account.
  61
  62    Use our `Phabricator user instructions <https://moz-conduit.readthedocs.io/en/latest/phabricator-user.html>`__ to upload patches for review.
  63    Some items that will be evaluated during code review are `listed in checklist form on
  64    Github. <https://github.com/mozilla/nss-tools/blob/master/nss-code-review-checklist.yaml>`__
  65
  66    After passing review, your patch can be landed by a member of the NSS team. Note that we don't land code that isn't both reviewed and tested.
  67
  68 .. warning::
  69
  70    Please reach out to the team before engaging in a lot of work to make ensure we are willing to accept your contributions.