Add-ons/Terminology

From MozillaWiki
< Add-ons
Revision as of 16:33, 21 July 2017 by AmyT (talk | contribs) (→‎Glossary: article)
Jump to navigation Jump to search

WebExtensions/Extensions/Add-ons

As of July 2017, we are moving away from calling extensions built with WebExtensions APIs "WebExtensions", and towards simply calling them "extensions". "WebExtensions" will still be used to describe the API that extensions are built on.

Background

When we first decided to move add-ons to a new API model, we needed a name for it that 1) was searchable 2) was distinguishable from legacy extensions and 3) signals its cross-browser interoperability. “WebExtensions” did all three, and we used it to describe extensions built with this new API.

Now that we’re close to completing the transition and supporting just one API for building extensions, we need to gradually drop the term “WebExtensions” when describing an extension built using the WebExtensions API.

Glossary

  • Add-on: an umbrella term that describes different types of code that extend Firefox. Mostly used on AMO. Includes extensions, themes, plug-ins, dictionaries, etc.
  • Extensions: pieces of code that extend the capabilities of a browser. In Firefox, extensions are a type of add-on.
  • Browser extensions: cross-browser extensions implemented using the Browser Extensions standard. (This article illustrates it nicely).
  • WebExtensions: a deprecated term that describes a Firefox extension built with WebExtensions APIs. Starting in Firefox 57, only extensions built with WebExtensions APIs will be supported. Therefore, we will start referring to them simply as "extensions". "WebExtensions" will remain in use in the context of describing the underlying technology of extensions.
  • Legacy extensions: a Firefox extension built using legacy APIs or the Add-on SDK.

Usage Guidelines

  • “Add-ons” and “Extensions” should not be used interchangeably.
  • Copy should say “Cool new extensions” rather than “Cool new WebExtensions”
  • "WebExtensions" should still be used when talking about the API that extensions are built on
  • For MDN extension documentation, formal cases (like the main title of the page) should say "Browser extensions", and thereafter "extensions" as an informal shorthand

addons.mozilla.org (AMO)

The site where you go to list and download add-ons is "addons.mozilla.org (AMO)" on the first mention, and "AMO" after that.

Questions?

When in doubt, please ask :kev, :jorgev, :wbamberg, or :amyt on irc.mozilla.org