Add-ons/Contribute: Difference between revisions

Fix links to good first bugs now that our GitHub labels have no spaces in them
(→‎Test add-ons: removed activate)
(Fix links to good first bugs now that our GitHub labels have no spaces in them)
 
(45 intermediate revisions by 6 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 =
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 />


== Subscribe to the Mailing List ==
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://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==
=Contribute to the Add-ons Ecosystem=
* '''[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 ==
== Create an Add-on ==
* [https://blog.mozilla.org/addons The Add-ons Blog]
=====Add-ons for Firefox Desktop=====
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.


== Contact us ==
=====Add-ons for Firefox for Android=====
* [https://wiki.mozilla.org/Add-ons/ACE Community Team]
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].
* IRC: [https://wiki.mozilla.org/IRC irc.mozilla.org], #amo, #addons, #extdev, #amo-editors channels
* Facebook: [https://www.facebook.com/mozaddons mozaddons]
* Twitter: [https://twitter.com/mozamo @mozamo]


= Public Meetings =
=====Port Add-ons to Firefox=====
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].
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!


=Contribute to the Add-ons Ecosystem=
== Improve add-ons in Firefox ==
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==
=====Contribute to the Add-on Manager in Firefox=====
[http://testpilot.firefox.com/ Try out] experimental Firefox features by installing an add-on and tell us how you like them!
The add-on manager is an integral part of the end-user's experience with addons.mozilla.org
* 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!
#Familiarize yourself with the on-boarding materials: [https://developer.mozilla.org/docs/Mozilla/Developer_guide/Introduction Onboard to Firefox codebase]
* More about the [https://wiki.mozilla.org/Test_Pilot Test Pilot project]
#Pick a [http://mzl.la/1JlF0hm "Good First Bug"] to work on


== Create an Add-on ==
=====Contribute to the WebExtensions API=====
=====Add-ons for Firefox Desktop=====
======''Good First Bugs''======
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.
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.  


=====Add-ons for Firefox for Android=====
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].
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].


== Improve add-ons in Firefox ==
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.  
[https://developer.mozilla.org/en-US/Add-ons/WebExtensions WebExtensions] is becoming 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=====
====== ''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 [https://mzl.la/2dVs5Ys approved APIs] that you can start contributing to.
*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.


*If you'd like to become familiar with Mozilla infrastructure so you can develop WebExtensions APIs directly for Firefox, follow these steps:
*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!
**Familiarize yourself with the on-boarding materials: [http://areweeveryoneyet.org/onramp/desktop.html Onboard to Firefox codebase]
**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 just 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 [[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 =====
===== Contribute code to AMO server =====
If you're new to Mozilla, and you know JavaScript and/or Python, get [https://wiki.mozilla.org/Add-ons/Contribute/Code 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 =====
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 64: 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].


===== Test add-ons =====
===== Join the Recommended Extensions Community Board  =====
*Do you know Python? Help write [https://github.com/mozilla/Addon-Tests/blob/master/README.md automated tests for AMO]!
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.
*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.
===== 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]].
 
== 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.
 
* 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 75: 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 to your Language.


=Contributor Recognition=
=Contributor Recognition=
Line 94: 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.
20

edits