Add-ons/Contribute: Difference between revisions

(Fixed good first bug links for AMO)
(Fix links to good first bugs now that our GitHub labels have no spaces in them)
 
(36 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Add-ons let you personalize your browsing experience in Firefox so you can make it your own. Your participation supports user freedom by ensuring that it remains the most customizable browser available.
Whether you're technical or not at all, there's a contribution opportunity for you. It's easy to get started, and your efforts help to make Firefox better!
 
= Connect with us =
 
== Subscribe to the Mailing List ==
* '''[https://mail.mozilla.org/listinfo/dev-addons Dev-addons]:''' Public mailing list for development of the add-on ecosystem including the site addons.mozilla.org and server extensions.


==General Discussion Forums==
We are committed to providing a friendly, safe, and welcoming environment for all. Our [https://www.mozilla.org/en-US/about/governance/policies/participation/ participation guidelines] set the standards for behavior in this community and all official Mozilla forums.<br />
* '''[https://discourse.mozilla-community.org/category/add-ons Add-ons Forum]:''' Discussions about add-on development, add-on support and addons.mozilla.org.  


== Latest News ==
Whether you are a regular contributor or a newcomer, we welcome you. If you feel you have been or are being harassed or made uncomfortable by a community member, please contact [mailto:cneiman@mozilla.com Caitlin Neiman], Add-ons Community Manager, or the [mailto:inclusion@mozilla.com Mozilla Diversity & Inclusion team], immediately.<br />
* [https://blog.mozilla.org/addons The Add-ons Blog]
 
== Contact us ==
* [https://wiki.mozilla.org/Add-ons/ACE Community Team]
* IRC: [https://wiki.mozilla.org/IRC irc.mozilla.org], #amo, #addons, #extdev, #addon-reviewers channels
* Facebook: [https://www.facebook.com/mozaddons mozaddons]
* Twitter: [https://twitter.com/mozamo @mozamo]
 
= Public Meetings =
See a list of all [https://www.google.com/calendar/embed?src=mozilla.com_lr5jsh38i6dmr72uu4d1nv7dcc%40group.calendar.google.com&ctz=America/Vancouver public add-on meetings].


=Contribute to the Add-ons Ecosystem=
=Contribute to the Add-ons Ecosystem=
Whether you're technical or not at all, there's a contribution opportunity for you. It's easy to get started, and your efforts help to make Firefox better!
==Test Pilot==
[http://testpilot.firefox.com/ Try out] experimental Firefox features by installing an add-on and tell us how you like them!
* If you find bugs, [https://github.com/mozilla/testpilot file an issue] at GitHub. If you got the coding skills and you're up for a challenge, help us fix the bugs!
* More about the [https://wiki.mozilla.org/Test_Pilot Test Pilot project]


== Create an Add-on ==
== Create an Add-on ==
=====Add-ons for Firefox Desktop=====
=====Add-ons for Firefox Desktop=====
To get started, check out this [https://developer.mozilla.org/en-US/Add-ons comprehensive tutorial]. It contains documentation, tools and information on how to get in touch with other developers. Need suggestions on what to build? Here is a [https://discourse.mozilla-community.org/search?q=idea%20category%3A35 list of add-ons] people have asked for.
To get started, check out this [https://developer.mozilla.org/Add-ons/WebExtensions/Your_first_WebExtension comprehensive tutorial]. It contains documentation, tools and information on how to get in touch with other developers. Need suggestions on what to build? Here is a [https://discourse.mozilla-community.org/search?q=idea%20category%3A35 list of add-ons] people have asked for.


=====Add-ons for Firefox for Android=====
=====Add-ons for Firefox for Android=====
Firefox for Android supports add-ons using the same extension system used by all other Gecko-based applications. Get started [https://developer.mozilla.org/en-US/Add-ons/Firefox_for_Android here].
The release version of Firefox for Android supports a limited number of [https://extensionworkshop.com/documentation/publish/recommended-extensions/ Recommended Extensions]. You can install other extensions listed on addons.mozilla.org using a [https://blog.mozilla.org/addons/2020/09/29/expanded-extension-support-in-firefox-for-android-nightly/ workaround] on Firefox for Android Nightly. For more information about developing extensions for Firefox for Android, see [https://extensionworkshop.com/documentation/develop/developing-extensions-for-firefox-for-android/ Firefox Extension Workshop].


=====Port Add-ons to Firefox=====
=====Port Add-ons to Firefox=====
It's easy to port Chrome extensions to Firefox. Read this [https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Porting_a_Google_Chrome_extension quick guide] and happy porting!
It's easy to port Chrome extensions to Firefox. Read this [https://extensionworkshop.com/documentation/develop/porting-a-google-chrome-extension/ quick guide] and happy porting!


== Improve add-ons in Firefox ==
== Improve add-ons in Firefox ==
[https://developer.mozilla.org/en-US/Add-ons/WebExtensions WebExtensions] are the standard for add-on development in Firefox. It seeks to unify the extension APIs and architecture with those of other browsers in the name of interoperability and modern architecture.


=====Develop WebExtensions APIs=====
=====Contribute to the Add-on Manager in Firefox=====
*If you're experienced with Mozilla infrastructure and would like to develop WebExtensions APIs directly for Firefox, here is a list of [https://mzl.la/2dVs5Ys approved APIs] that you can start contributing to.
The add-on manager is an integral part of the end-user's experience with addons.mozilla.org
#Familiarize yourself with the on-boarding materials: [https://developer.mozilla.org/docs/Mozilla/Developer_guide/Introduction Onboard to Firefox codebase]
#Pick a [http://mzl.la/1JlF0hm "Good First Bug"] to work on
 
=====Contribute to the WebExtensions API=====
======''Good First Bugs''======
If you'd like to contribute to the WebExtensions API and are new to the Firefox code base, we recommend getting started with a good-first-bug.
 
Visit our [[WebExtensions/Contribution_Onramp|WebExtensions Contribution Onramp]] to onboard to the code base and get started with a [https://mzl.la/2yq1XA8 good-first bug]
 
You may also want to read [https://blog.mozilla.org/addons/2018/08/14/building-extension-apis-oriol-brafau/ this blog post] for tips on how to contribute to the WebExtensions API.  


*If you'd like to become familiar with Mozilla infrastructure so you can develop WebExtensions APIs directly for Firefox, follow these steps:
====== ''Develop WebExtensions APIs'' ======
**Familiarize yourself with the on-boarding materials: [http://areweeveryoneyet.org/onramp/desktop.html Onboard to Firefox codebase]
*If you're experienced with Mozilla infrastructure and would like to develop WebExtensions APIs directly for Firefox, here is a list of [https://mzl.la/2vrKSSy approved APIs] that you can start contributing to.
**Pick a [https://bugzilla.mozilla.org/buglist.cgi?quicksearch=component%3AWebExtensions%20keyword%3Agood-first-bug&list_id=13160623 "Good First Bug"] to work on


*If you want to tinker with WebExtensions APIs without having to build Firefox, [http://webextensions-experiments.readthedocs.io/en/latest/index.html WebExtensions Experiments] is for you!
*If you want to tinker with WebExtensions APIs without having to build Firefox, [http://webextensions-experiments.readthedocs.io/en/latest/index.html WebExtensions Experiments] is for you!


*If you simply want to request a WebExtensions API, please [https://bugzilla.mozilla.org/enter_bug.cgi?product=Toolkit&component=WebExtensions:%20Untriaged file a bug]. These will be triaged and processed in a [https://wiki.mozilla.org/Add-ons/Contribute/Triage bi-weekly public meeting].
*If you simply want to request a WebExtensions API, please [[WebExtensions/NewAPIs|read this information]] before filing a bug.


== Improve addons.mozilla.org (AMO) ==
== Improve addons.mozilla.org (AMO) ==
Addons.mozilla.org, commonly known as "AMO," is Mozilla's official site for developers to list add-ons, and for users to discover them.
Addons.mozilla.org, commonly known as "AMO" is Mozilla's official site for developers to list add-ons, and for users to discover them.


===== Contribute code to AMO server =====
===== Contribute code to AMO server =====
If you're new to Mozilla, and you know Python, get [https://github.com/mozilla/addons-server/labels/contrib%3A%20good%20first%20bug onboarded and work on a "Good First Bug"]!
If you're new to Mozilla, and you know Python, get [[Add-ons/Contribute/Code|onboarded here]] [https://github.com/mozilla/addons-server/labels/contrib%3Agood_first_bug and work on a "Good First Bug"]!


===== Contribute code to AMO front-end =====
===== Contribute code to AMO front-end =====
If you're interested in JavaScript and front-end technologies such as [https://facebook.github.io/react/ React] and [http://redux.js.org/ Redux], take a look at [https://github.com/mozilla/addons-frontend/labels/contrib%3A%20good%20first%20bug "Good First Bugs" in the front-end repository].
If you're interested in JavaScript and front-end technologies such as [https://facebook.github.io/react/ React] and [http://redux.js.org/ Redux], take a look at [https://github.com/mozilla/addons-frontend/labels/contrib%3Agood_first_bug "Good First Bugs" in the front-end repository].


===== Become an Add-on Reviewer =====
===== Become an Add-on Reviewer =====
Volunteer reviewers ensure the security and reliability of add-ons on AMO by testing every submission. Learn how you can [https://wiki.mozilla.org/AMO:Reviewers join this community].
Volunteer reviewers ensure the security and reliability of add-ons on AMO by testing submissions. Learn how you can [https://wiki.mozilla.org/AMO:Reviewers join this community].


===== Rate your favorite add-ons =====
===== Rate your favorite add-ons =====
Line 72: Line 58:


===== Create a theme =====
===== Create a theme =====
Lightweight themes let you personalize the look of your Firefox. To create your own, [https://developer.mozilla.org/Add-ons/Themes/Background start here].
Themes let you personalize the look of your Firefox. To create your own, [https://extensionworkshop.com/documentation/themes/ start here].


===== Join the Featured Add-ons Advisory Board =====
===== Join the Recommended Extensions Community Board =====
The [https://developer.mozilla.org/en-US/Add-ons/AMO/Policy/Featured#Joining_the_Featured_Add-ons_Advisory_Board Featured Add-ons Advisory Board] is comprised of a small group of community members who help select each month's [https://addons.mozilla.org/en-US/firefox/extensions/?sort=featured featured add-ons]. Every board serves for six months, then a new group of community curators take over. Check the [https://blog.mozilla.org/addons/ Add-ons Blog] to learn when the next application period opens and for application instructions.  
The Recommended Extensions Community Board is comprised of a small group of community members who help with the ongoing evaluation of of new and current [https://addons.mozilla.org/firefox/search/?recommended=true&sort=random&type=extension Recommended Extensions] and other special projects. Every board serves for six months, then a new group of community curators take over. Check the [https://blog.mozilla.org/addons/ Add-ons Blog] to learn when the next application period opens and for application instructions.


===== Curate Featured Themes collection =====
===== Curate Featured Themes collection =====
Help us curate Mozilla's [https://addons.mozilla.org/en-US/firefox/collections/mozilla/featured-personas Featured Themes] collection to help users find high-quality themes. [[Add-ons/Contribute/Featured_Themes|Learn more and apply to be a curator]].  
Help us curate Mozilla's [https://addons.mozilla.org/en-US/firefox/collections/mozilla/featured-personas Featured Themes] collection to help users find high-quality themes. [[Add-ons/Contribute/Featured_Themes|Learn more and apply to be a curator]].  
===== Test add-ons =====
*Do you know Python? Help write [https://github.com/mozilla/Addon-Tests/blob/master/README.md automated tests for AMO]!
*To help test '''addons.mozilla.org (AMO)''', please take a look at this [https://oneanddone.mozilla.org/tasks/11/ list of tests].
*It's also helpful to install the [https://addons.mozilla.org/firefox/addon/add-on-compatibility-reporter Add-ons Compatibility Reporter] and use it to let us know when an add-on is not working properly. The latest version gives you an easy way to report [https://developer.mozilla.org/en-US/Firefox/Multiprocess_Firefox multiprocess Firefox] compatibility.


== Contribute to add-on developer tools ==
== Contribute to add-on developer tools ==
* [https://github.com/mozilla/web-ext Web-Ext] is a tool for developing WebExtensions. Check out the [https://github.com/mozilla/web-ext/blob/master/CONTRIBUTING.md contributing guide] to get started.
* [https://github.com/mozilla/web-ext Web-Ext] is a tool for developing WebExtensions. Check out the [https://github.com/mozilla/web-ext/blob/master/CONTRIBUTING.md contributing guide] to get started.
* The [https://github.com/mozilla/addons-linter add-ons linter] checks for errors and validates extensions submitted to addons.mozilla.org. Check out the [https://github.com/mozilla/addons-linter/blob/master/CONTRIBUTING.md contributing guide] to get started.
* [https://github.com/mozilla/webextension-polyfill Webextensions-polyfill] is a library designed to help developers create extensions that are compatible across multiple browsers. See the [https://github.com/mozilla/webextension-polyfill/blob/master/CONTRIBUTING.md contributing guide] for how to get started.


== Help add-on users ==
== Help add-on users ==
Line 92: Line 77:


== Help add-on developers ==
== Help add-on developers ==
If you're already familiar with add-on development or you think you're a good technical writer, help us improve the documentation for add-on developers: https://developer.mozilla.org/en-US/Add-ons
If you're already familiar with add-on development or you think you're a good technical writer, help us improve the WebExtensions API reference documentation on [https://developer.mozilla.org/Add-ons MDN] or the Firefox-specific documentation for add-on developers on [https://extensionworkshop.com Extension Workshop]. The list of open issues for Extension Workshop can be found on in the [https://github.com/mozilla/extension-workshop/issues extension-workshop repository] on Github.


You can also help by translating these docs to a different language (pro tip: try replacing the en-US part of the link above to your native language code).
You can also help by translating docs on MDN to a different language (pro tip: try replacing the en-US part of the link above to your native language code).


==Localization==
==Localization==
*'''MDN's "localization priorities" list''' - We're always in need of translators--here are the [https://developer.mozilla.org/en-US/search?q=mdn+localization+priorities&topic=addons priority projects] for add-ons.
*'''MDN's "localization priorities" list''' - We're always in need of translators--here are the [https://developer.mozilla.org/en-US/search?q=mdn+localization+priorities&topic=addons priority projects] for add-ons
*'''Localize an add-on''' - Join the [http://babelzilla.org Babelzilla community] and help translate add-ons to your language.
*'''Localize addons.mozilla.org''' - Join [https://pontoon.mozilla.org/en-GB/amo/ Pontoon] and translate addons.mozilla.org [https://pontoon.mozilla.org/projects/amo-frontend/ frontend] or [https://pontoon.mozilla.org/projects/amo/ backend] to your Language.
*'''Localize addons.mozilla.org''' - Join [https://pontoon.mozilla.org/en-GB/amo/ Pontoon] and translate addons.mozilla.org [https://pontoon.mozilla.org/projects/amo-frontend/ frontend] or [https://pontoon.mozilla.org/projects/amo/ backend] to your Language.


Line 111: Line 95:
==Friends of Add-ons==
==Friends of Add-ons==
Big thanks to these [https://blog.mozilla.org/addons/category/featured-contributors/ outstanding volunteer contributors]!
Big thanks to these [https://blog.mozilla.org/addons/category/featured-contributors/ outstanding volunteer contributors]!
= Connect With the Community =
Check out our [[Add-ons/Community/|Community wiki]] to learn more about our community forums, mailing lists, blog, and other ways to get in touch.

Latest revision as of 11:56, 11 January 2023

Whether you're technical or not at all, there's a contribution opportunity for you. It's easy to get started, and your efforts help to make Firefox better!

We are committed to providing a friendly, safe, and welcoming environment for all. Our participation guidelines set the standards for behavior in this community and all official Mozilla forums.

Whether you are a regular contributor or a newcomer, we welcome you. If you feel you have been or are being harassed or made uncomfortable by a community member, please contact Caitlin Neiman, Add-ons Community Manager, or the Mozilla Diversity & Inclusion team, immediately.

Contribute to the Add-ons Ecosystem

Create an Add-on

Add-ons for Firefox Desktop

To get started, check out this comprehensive tutorial. It contains documentation, tools and information on how to get in touch with other developers. Need suggestions on what to build? Here is a list of add-ons people have asked for.

Add-ons for Firefox for Android

The release version of Firefox for Android supports a limited number of Recommended Extensions. You can install other extensions listed on addons.mozilla.org using a workaround on Firefox for Android Nightly. For more information about developing extensions for Firefox for Android, see Firefox Extension Workshop.

Port Add-ons to Firefox

It's easy to port Chrome extensions to Firefox. Read this quick guide and happy porting!

Improve add-ons in Firefox

Contribute to the Add-on Manager in Firefox

The add-on manager is an integral part of the end-user's experience with addons.mozilla.org

  1. Familiarize yourself with the on-boarding materials: Onboard to Firefox codebase
  2. Pick a "Good First Bug" to work on
Contribute to the WebExtensions API
Good First Bugs

If you'd like to contribute to the WebExtensions API and are new to the Firefox code base, we recommend getting started with a good-first-bug.

Visit our WebExtensions Contribution Onramp to onboard to the code base and get started with a good-first bug.

You may also want to read this blog post for tips on how to contribute to the WebExtensions API.

Develop WebExtensions APIs
  • If you're experienced with Mozilla infrastructure and would like to develop WebExtensions APIs directly for Firefox, here is a list of approved APIs that you can start contributing to.

Improve addons.mozilla.org (AMO)

Addons.mozilla.org, commonly known as "AMO" is Mozilla's official site for developers to list add-ons, and for users to discover them.

Contribute code to AMO server

If you're new to Mozilla, and you know Python, get onboarded here and work on a "Good First Bug"!

Contribute code to AMO front-end

If you're interested in JavaScript and front-end technologies such as React and Redux, take a look at "Good First Bugs" in the front-end repository.

Become an Add-on Reviewer

Volunteer reviewers ensure the security and reliability of add-ons on AMO by testing submissions. Learn how you can join this community.

Rate your favorite add-ons

Search for your favorite add-on at https://addons.mozilla.org. On the add-on's detail page, scroll down to the Reviews section and leave a comment for the developer.

Create a collection

Collections make it easy to keep track of favorite add-ons and share your perfectly customized browser with others. Get started here.

Create a theme

Themes let you personalize the look of your Firefox. To create your own, start here.

Join the Recommended Extensions Community Board

The Recommended Extensions Community Board is comprised of a small group of community members who help with the ongoing evaluation of of new and current Recommended Extensions and other special projects. Every board serves for six months, then a new group of community curators take over. Check the Add-ons Blog to learn when the next application period opens and for application instructions.

Curate Featured Themes collection

Help us curate Mozilla's Featured Themes collection to help users find high-quality themes. Learn more and apply to be a curator.

Contribute to add-on developer tools

Help add-on users

Answer questions from add-on users in the Firefox Support Forum!

Help add-on developers

If you're already familiar with add-on development or you think you're a good technical writer, help us improve the WebExtensions API reference documentation on MDN or the Firefox-specific documentation for add-on developers on Extension Workshop. The list of open issues for Extension Workshop can be found on in the extension-workshop repository on Github.

You can also help by translating docs on MDN to a different language (pro tip: try replacing the en-US part of the link above to your native language code).

Localization

  • MDN's "localization priorities" list - We're always in need of translators--here are the priority projects for add-ons
  • Localize addons.mozilla.org - Join Pontoon and translate addons.mozilla.org frontend or backend to your Language.

Contributor Recognition

Report Your Contributions

We want to make sure you're recognized for your contributions!

  1. Create a Mozillians profile if you haven't already.
  2. Add your name and accomplishments on the Recognition wiki page (please be specific--these will be archived by month, so list your recent contributions).

We regularly choose an outstanding contributor (Friend of Add-ons) and send that person a token of appreciation. Any contribution is eligible--it doesn't have to be an opportunity listed on this page!

Friends of Add-ons

Big thanks to these outstanding volunteer contributors!

Connect With the Community

Check out our Community wiki to learn more about our community forums, mailing lists, blog, and other ways to get in touch.