feat(nimbus): Add Firefox Labs Description Links field

Because:

- We want to publish the Firefox Labs Description Links field

This commit:

- Updates Experimenter to mozila-nimbus-schemas 2025.1.1; and
- Adds a `firefox_labs_description_links` field to the
  `NimbusExperiment` model.

Fixes #12133

experimenter/experimenter/experiments/api/v6/serializers.py

@@ -115,6 +115,7 @@ class NimbusExperimentSerializer(serializers.ModelSerializer):
     isFirefoxLabsOptIn = serializers.ReadOnlyField(source="is_firefox_labs_opt_in")
     firefoxLabsTitle = serializers.ReadOnlyField(source="firefox_labs_title")
     firefoxLabsDescription = serializers.ReadOnlyField(source="firefox_labs_description")
+    firefoxLabsDescriptionLinks = serializers.ReadOnlyField(source="firefox_labs_description_links")
     firefoxLabsGroup = serializers.ReadOnlyField(source="firefox_labs_group")
     requiresRestart = serializers.ReadOnlyField(source="requires_restart")
 
@@ -152,6 +153,7 @@ class Meta:
             "isFirefoxLabsOptIn",
             "firefoxLabsTitle",
             "firefoxLabsDescription",
+            "firefoxLabsDescriptionLinks",
             "firefoxLabsGroup",
             "requiresRestart",
         )

experimenter/experimenter/experiments/migrations/0277_nimbusexperiment_firefox_labs_description_links.py

@@ -0,0 +1,20 @@
+# Generated by Django 5.1.5 on 2025-02-03 18:57
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("experiments", "0276_nimbusexperiment_requires_restart"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="nimbusexperiment",
+            name="firefox_labs_description_links",
+            field=models.JSONField(
+                default=None, null=True, verbose_name="Firefox Labs Description Links"
+            ),
+        ),
+    ]

experimenter/experimenter/experiments/models.py

@@ -384,6 +384,11 @@ class NimbusExperiment(NimbusConstants, TargetingConstants, FilterMixin, models.
         blank=True,
         null=True,
     )
+    firefox_labs_description_links = models.JSONField[dict[str, str]](
+        "Firefox Labs Description Links",
+        null=True,
+        default=None,
+    )
     firefox_labs_group = models.CharField(
         "The group this should appear under in Firefox Labs",
         blank=True,

experimenter/experimenter/experiments/tests/api/v6/test_serializers.py

@@ -117,6 +117,7 @@ def test_expected_schema_with_desktop(self):
                 "isFirefoxLabsOptIn": False,
                 "firefoxLabsTitle": None,
                 "firefoxLabsDescription": None,
+                "firefoxLabsDescriptionLinks": None,
                 "firefoxLabsGroup": None,
                 "requiresRestart": False,
             },
@@ -183,6 +184,9 @@ def test_expected_schema_with_desktop_with_non_default_fxlabs_fields(self):
             is_firefox_labs_opt_in=True,
             firefox_labs_title="test-fx-labs-title",
             firefox_labs_description="test-fx-labs-description",
+            firefox_labs_description_links={
+                "foo": "https://example.com",
+            },
             firefox_labs_group="group",
             requires_restart=True,
         )
@@ -198,6 +202,9 @@ def test_expected_schema_with_desktop_with_non_default_fxlabs_fields(self):
                 "isFirefoxLabsOptIn": True,
                 "firefoxLabsTitle": "test-fx-labs-title",
                 "firefoxLabsDescription": "test-fx-labs-description",
+                "firefoxLabsDescriptionLinks": {
+                    "foo": "https://example.com",
+                },
                 "firefoxLabsGroup": "group",
                 "requiresRestart": True,
             }

experimenter/experimenter/experiments/tests/factories.py

@@ -483,6 +483,7 @@ class NimbusExperimentFactory(factory.django.DjangoModelFactory):
     firefox_labs_description = factory.LazyAttribute(
         lambda o: faker.catch_phrase() if o.is_firefox_labs_opt_in else None
     )
+    firefox_labs_description_links = factory.LazyAttribute(lambda o: None)
     firefox_labs_group = factory.LazyAttribute(
         lambda o: (
             random.choice(NimbusExperiment.FirefoxLabsGroups.choices)[0]

experimenter/experimenter/experiments/tests/test_changelog_utils.py

@@ -60,6 +60,7 @@ def test_outputs_expected_schema_for_empty_experiment(self):
                 "firefox_min_version": NimbusExperiment.Version.NO_VERSION,
                 "firefox_labs_title": experiment.firefox_labs_title,
                 "firefox_labs_description": experiment.firefox_labs_description,
+                "firefox_labs_description_links": experiment.firefox_labs_description_links,
                 "firefox_labs_group": experiment.firefox_labs_group,
                 "hypothesis": NimbusExperiment.HYPOTHESIS_DEFAULT,
                 "is_archived": experiment.is_archived,
@@ -173,6 +174,7 @@ def test_outputs_expected_schema_for_complete_experiment(self):
                 "firefox_min_version": experiment.firefox_min_version,
                 "firefox_labs_title": experiment.firefox_labs_title,
                 "firefox_labs_description": experiment.firefox_labs_description,
+                "firefox_labs_description_links": experiment.firefox_labs_description_links,
                 "firefox_labs_group": experiment.firefox_labs_group,
                 "hypothesis": experiment.hypothesis,
                 "is_archived": experiment.is_archived,

experimenter/pyproject.toml

@@ -64,7 +64,7 @@ djangorestframework-dataclasses = "^1.3.0"
 graphene-django = "^3.2.0"
 pyright = "^1.1.291"
 django-types = "^0.20.0"
-mozilla-nimbus-schemas = "2024.12.2"
+mozilla-nimbus-schemas = "2025.1.1"
 mozilla-metric-config-parser = "^2024.11.1"
 django-redis = "^5.4.0"
 fontawesomefree = "6.6.0"