rm TAAR service integrations (mozilla#23147)

* rm TAAR service integrations

* delete waffle switch too

Author: eviljeff

docs/topics/api/addons.rst

@@ -957,7 +957,7 @@ Replacement Add-ons
 
 .. _addon-replacement-addons:
 
-This endpoint returns a list of suggested replacements for legacy add-ons that are unsupported in Firefox 57.  Added to support the TAAR recommendation service.
+This endpoint returns a list of suggested replacements for legacy add-ons that are unsupported in Firefox 57.
 
 .. http:get:: /api/v5/addons/replacement-addon/
 
@@ -977,17 +977,16 @@ Recommendations
 
 .. _addon-recommendations:
 
-This endpoint provides recommendations of other addons to install, fetched from the `recommendation service <https://github.com/mozilla/taar>`_.
-Four recommendations are fetched, but only valid, publicly available addons are shown (so max 4 will be returned, and possibly less).
+This endpoint provides recommendations of other addons to install. Maximum four recommendations will be returned.
 
 .. http:get:: /api/v5/addons/recommendations/
 
     :query string app: Set the :ref:`add-on application <addon-detail-application>` for that query. This won't filter the results. Defaults to ``firefox``.
     :query string guid: Fetch recommendations for this add-on guid.
     :query string lang: Activate translations in the specific language for that query. (See :ref:`translated fields <api-overview-translations>`)
-    :query boolean recommended: Fetch recommendations from the recommendation service, or return a curated fallback list instead.
-    :>json string outcome: Outcome of the response returned.  Will be either: ``recommended`` - responses from recommendation service; ``recommended_fallback`` - service timed out or returned empty or invalid results so we returned fallback; ``curated`` - ``recommended=False`` was requested so fallback returned.
-    :>json string|null fallback_reason: if ``outcome`` was ``recommended_fallback`` then the reason why.  Will be either: ``timeout``, ``no_results``, or ``invalid_results``.
+    :query boolean recommended: Ignored.
+    :>json string outcome: Outcome of the response returned. Will always be ``curated``.
+    :>json null fallback_reason: Always null.
     :>json int count: The number of results for this query.
     :>json string next: The URL of the next page of results.
     :>json string previous: The URL of the previous page of results.

docs/topics/api/discovery.rst

@@ -21,25 +21,17 @@ Firefox (about:addons).
 
 .. note::
 
-    If a telemetry client id is passed as a parameter to the discovery pane api
-    endpoint then static curated content is amended with recommendations from the
-    `recommendation service <https://github.com/mozilla/taar>`_.  The same number
-    of results will be returned as a standard discovery response and only extensions
-    (not themes) are recommended.  Only valid, publicly available addons are shown.
-
-    E.g. a standard discovery pane will display 7 items, 4 extensions and 3 themes.
-    Up to 4 extensions will be replaced with recommendations; the 3 themes will not
-    be replaced. The API will still return a total of 7 items.
+    A standard discovery pane will display 7 items, 4 extensions and 3 themes.
 
 .. http:get:: /api/v5/discovery/
 
-    :query string lang: Activate translations in the specific language for that query. (See :ref:`translated fields <api-overview-translations>`)
+    :query string lang: Activates translations. (See :ref:`translated fields <api-overview-translations>`)
     :query string edition: Optionally return content for a specific edition of Firefox.  Currently only ``china`` (and the alias ``MozillaOnline``)  is supported.
-    :query string telemetry-client-id: Optional sha256 hash of the telemetry client ID to be passed to the TAAR service to enable recommendations. Must be the hex value of a sha256 hash, otherwise it will be ignored.
+    :query string telemetry-client-id: Ignored. Was previously an optional sha256 hash of the telemetry client ID to be passed to the TAAR service to enable recommendations.
     :>json int count: The number of results for this query.
     :>json array results: The array containing the results for this query.
     :>json object|null results[].description_text: The description for this item, if any. (See :ref:`translated fields <api-overview-translations>`.  Note: when ``lang`` is not specified, not all locales will be returned, unlike other translated fields).
-    :>json boolean results[].is_recommendation: If this item was from the recommendation service, rather than static curated content.
+    :>json boolean results[].is_recommendation: Always False.
     :>json object results[].addon: The :ref:`add-on <addon-detail-object>` for this item. Only a subset of fields are present: ``id``, ``authors``, ``average_daily_users``, ``current_version`` (with only the ``id``, ``compatibility``, ``is_strict_compatibility_enabled`` and ``file`` fields present), ``guid``, ``icon_url``, ``name``, ``ratings``, ``previews``, ``slug``, ``theme_data``, ``type`` and ``url``.
 
 
@@ -51,8 +43,7 @@ Editorial Content
 
 This endpoint allows you to fetch all editorial content for Discovery Pane
 Recommendations. This is used internally to generate .po files containing the
-strings defined by the content team.  It is also used by TAAR service to obtain a list
-of appropriate add-ons to recommended.
+strings defined by the content team.
 
  .. http:get:: /api/v5/discovery/editorial/
 

docs/topics/api/v3_legacy/addons.rst

@@ -456,7 +456,7 @@ Replacement Add-ons
 
 .. _v3-addon-replacement-addons:
 
-This endpoint returns a list of suggested replacements for legacy add-ons that are unsupported in Firefox 57.  Added to support the TAAR recommendation service.
+This endpoint returns a list of suggested replacements for legacy add-ons that are unsupported in Firefox 57.
 
 .. http:get:: /api/v3/addons/replacement-addon/
 
@@ -508,16 +508,15 @@ Recommendations
 
 .. _v3-addon-recommendations:
 
-This endpoint provides recommendations of other addons to install, fetched from the `recommendation service <https://github.com/mozilla/taar>`_.
-Four recommendations are fetched, but only valid, publicly available addons are shown (so max 4 will be returned, and possibly less).
+This endpoint provides recommendations of other addons to install. Maximum four recommendations will be returned.
 
 .. http:get:: /api/v3/addons/recommendations/
 
     :query string guid: Fetch recommendations for this add-on guid.
     :query string lang: Activate translations in the specific language for that query. (See :ref:`translated fields <v3-api-overview-translations>`)
-    :query boolean recommended: Fetch recommendations from the recommendation service, or return a curated fallback list instead.
-    :>json string outcome: Outcome of the response returned.  Will be either: ``recommended`` - responses from recommendation service; ``recommended_fallback`` - service timed out or returned empty results so we returned fallback; ``curated`` - ``recommended=False`` was requested so fallback returned.
-    :>json string|null fallback_reason: if ``outcome`` was ``recommended_fallback`` then the reason why.  Will be either: ``timeout`` or ``no_results``.
+    :query boolean recommended: Ignored.
+    :>json string outcome: Outcome of the response returned. Will always be ``curated``.
+    :>json null fallback_reason: Always null.
     :>json int count: The number of results for this query.
     :>json string next: The URL of the next page of results.
     :>json string previous: The URL of the previous page of results.

docs/topics/api/v3_legacy/discovery.rst

@@ -25,7 +25,7 @@ Firefox (about:addons).
     :>json array results: The array containing the results for this query.
     :>json string results[].heading: The heading for this item. May contain some HTML tags.
     :>json string|null results[].description: The description for this item, if any. May contain some HTML tags.
-    :>json boolean results[].is_recommendation: If this item was from the recommendation service, rather than static curated content.
+    :>json boolean results[].is_recommendation: Always False
     :>json object results[].addon: The :ref:`add-on <v3-addon-detail-object>` for this item. Only a subset of fields are present: ``id``, ``current_version`` (with only the ``compatibility`` and ``files`` fields present), ``guid``, ``icon_url``, ``name``, ``slug``, ``theme_data``, ``type`` and ``url``.
 
 
@@ -35,25 +35,21 @@ Discovery Recommendations
 
 .. _v3-disco-recommendations:
 
-If a telemetry client id is passed as a parameter to the discovery pane api
-endpoint then static curated content is amended with recommendations from the
-`recommendation service <https://github.com/mozilla/taar>`_.  The same number
-of results will be returned as a standard discovery response and only extensions
-(not themes) are recommended.  Only valid, publicly available addons are shown.
-
 E.g. a standard discovery pane will display 7 items, 4 extensions and 3 themes.
 Up to 4 extensions will be replaced with recommendations; the 3 themes will not
 be replaced. The API will still return a total of 7 items.
 
 .. note::
+    A standard discovery pane will display 7 items, 4 extensions and 3 themes.
+
     Specifying an ``edition`` parameter disables recommendations - the ``telemetry-client-id``
     is ignored and standard discovery response returned.
 
 
  .. http:get:: /api/v3/discovery/?telemetry-client-id=12345678-90ab-cdef-1234-567890abcdef
 
-    :query string telemetry-client-id: The telemetry client ID to be passed to the TAAR service.
-    :query string lang: In addition to activating translations (see :ref:`Discovery Content <v3-disco-content>`), this will be passed as `locale` to TAAR.
-    :query string platform: The platform identifier to be passed to TAAR.
-    :query string branch: Additional parameter passed along to TAAR.
-    :query string study: Additional parameter passed along to TAAR.
+    :query string telemetry-client-id: Ignored. Was previously an optional sha256 hash of the telemetry client ID to be passed to the TAAR service to enable recommendations.
+    :query string lang: Activates translations (see :ref:`Discovery Content <v3-disco-content>`).
+    :query string platform: Ignored.
+    :query string branch: Ignored.
+    :query string study: Ignnored.

docs/topics/api/v4_frozen/addons.rst

@@ -457,7 +457,7 @@ Replacement Add-ons
 
 .. _v4-addon-replacement-addons:
 
-This endpoint returns a list of suggested replacements for legacy add-ons that are unsupported in Firefox 57.  Added to support the TAAR recommendation service.
+This endpoint returns a list of suggested replacements for legacy add-ons that are unsupported in Firefox 57.
 
 .. http:get:: /api/v4/addons/replacement-addon/
 
@@ -477,17 +477,15 @@ Recommendations
 
 .. _v4-addon-recommendations:
 
-This endpoint provides recommendations of other addons to install, fetched from the `recommendation service <https://github.com/mozilla/taar>`_.
-Four recommendations are fetched, but only valid, publicly available addons are shown (so max 4 will be returned, and possibly less).
+This endpoint provides recommendations of other addons to install. Maximum four recommendations will be returned.
 
 .. http:get:: /api/v4/addons/recommendations/
 
     :query string guid: Fetch recommendations for this add-on guid.
     :query string lang: Activate translations in the specific language for that query. (See :ref:`translated fields <v4-api-overview-translations>`)
-    :query boolean recommended: Fetch recommendations from the recommendation service, or return a curated fallback list instead.
-    :>json string outcome: Outcome of the response returned.  Will be either: ``recommended`` - responses from recommendation service; ``recommended_fallback`` - service timed out or returned empty or invalid results so we returned fallback; ``curated`` - ``recommended=False`` was requested so fallback returned.
-    :>json string|null fallback_reason: if ``outcome`` was ``recommended_fallback`` then the reason why.  Will be either: ``timeout``, ``no_results``, or ``invalid_results``.
-    :>json int count: The number of results for this query.
+    :query boolean recommended: Ignored.
+    :>json string outcome: Outcome of the response returned. Will always be ``curated``.
+    :>json null fallback_reason: Always null.:>json int count: The number of results for this query.
     :>json string next: The URL of the next page of results.
     :>json string previous: The URL of the previous page of results.
     :>json array results: An array of :ref:`add-ons <v4-addon-detail-object>`. The following fields are omitted for performance reasons: ``release_notes`` and ``license`` fields on ``current_version`` and ``current_beta_version``, as well as ``picture_url`` from ``authors``.

docs/topics/api/v4_frozen/discovery.rst

@@ -21,25 +21,17 @@ Firefox (about:addons).
 
 .. note::
 
-    If a telemetry client id is passed as a parameter to the discovery pane api
-    endpoint then static curated content is amended with recommendations from the
-    `recommendation service <https://github.com/mozilla/taar>`_.  The same number
-    of results will be returned as a standard discovery response and only extensions
-    (not themes) are recommended.  Only valid, publicly available addons are shown.
-
-    E.g. a standard discovery pane will display 7 items, 4 extensions and 3 themes.
-    Up to 4 extensions will be replaced with recommendations; the 3 themes will not
-    be replaced. The API will still return a total of 7 items.
+    A standard discovery pane will display 7 items, 4 extensions and 3 themes.
 
 .. http:get:: /api/v4/discovery/
 
-    :query string lang: Activate translations in the specific language for that query. (See :ref:`translated fields <v4-api-overview-translations>`)
+    :query string lang: Activates translations. (See :ref:`translated fields <v4-api-overview-translations>`)
     :query string edition: Optionally return content for a specific edition of Firefox.  Currently only ``china`` (and the alias ``MozillaOnline``)  is supported.
-    :query string telemetry-client-id: Optional sha256 hash of the telemetry client ID to be passed to the TAAR service to enable recommendations. Must be the hex value of a sha256 hash, otherwise it will be ignored.
+    :query string telemetry-client-id: Ignored. Was previously an optional sha256 hash of the telemetry client ID to be passed to the TAAR service to enable recommendations.
     :>json int count: The number of results for this query.
     :>json array results: The array containing the results for this query.
     :>json string|null results[].description_text: The description for this item, if any. Text-only, content might slightly differ from ``description`` because of that.
-    :>json boolean results[].is_recommendation: If this item was from the recommendation service, rather than static curated content.
+    :>json boolean results[].is_recommendation: Always False.
     :>json object results[].addon: The :ref:`add-on <v4-addon-detail-object>` for this item. Only a subset of fields are present: ``id``, ``authors``, ``average_daily_users``, ``current_version`` (with only the ``id``, ``compatibility``, ``is_strict_compatibility_enabled`` and ``files`` fields present), ``guid``, ``icon_url``, ``name``, ``ratings``, ``previews``, ``slug``, ``theme_data``, ``type`` and ``url``.
 
 
@@ -51,8 +43,7 @@ Editorial Content
 
 This endpoint allows you to fetch all editorial content for Discovery Pane
 Recommendations. This is used internally to generate .po files containing the
-strings defined by the content team.  It is also used by TAAR service to obtain a list
-of appropriate add-ons to recommended.
+strings defined by the content team.
 
  .. http:get:: /api/v4/discovery/editorial/