Skip to content

Doc fixes (2026-10-15) - #919

Draft
scholtzan wants to merge 22 commits into
mainfrom
doc-fixes-2026-10-15
Draft

scholtzan wants to merge 22 commits into
mainfrom
doc-fixes-2026-10-15

Conversation

@scholtzan

Copy link
Copy Markdown
Contributor

Doc fixes drafted by the doc-correctness platform. Each commit fixes one finding and carries its Finding-Id and sources. Internal sources are linked, never quoted. Reviewed: ✓ = a reviewer already confirmed the finding; new = this PR is its review.

Review: keep, edit, or drop commits; comment on lines that are wrong. Kept/edited/dropped commits and comments are read back as feedback.

File Change Sources Reviewed Finding
concepts/pipeline/artifact_deployment.md Correct UDF deploy trigger from nightly to CircleCI/Jenkins https://github.com/mozilla/telemetry-airflow/blob/main/dags/bqetl_artifact_deployment.py new df663f5a
concepts/pipeline/artifact_deployment.md Replace retired publish_new_tables task with publish_tables_and_views https://github.com/mozilla/telemetry-airflow/blob/main/dags/bqetl_artifact_deployment.py new dab45127
concepts/pipeline/artifact_deployment.md Replace retired publish_views task with publish_tables_and_views https://github.com/mozilla/telemetry-airflow/blob/main/dags/bqetl_artifact_deployment.py new 55db0524
concepts/pipeline/event_pipeline.md Note Glean API has replaced legacy Telemetry event APIs on Desktop https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/collection/events.html https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/collection/webextension-api.html https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/start/adding-a-new-probe.html new 5cef8132
cookbooks/data_modeling.md Mention shredder mitigation cookbook on index page https://github.com/mozilla/data-docs/blob/main/src/cookbooks/data_modeling/shredder_mitigation.md new b787147c
cookbooks/data_monitoring/intro.md Add note on code-based (bigconfig.yml/bqetl) monitoring setup https://github.com/mozilla/bigquery-etl/blob/main/bigquery_etl/cli/monitoring.py new 96558af2
cookbooks/scheduling_queries.md Note Looker is now preferred over STMO for new dashboards https://docs.telemetry.mozilla.org/introduction/tools https://docs.telemetry.mozilla.org/tools/stmo new 0957007d
cookbooks/scheduling_queries.md Document manual unpausing of new DAGs in Airflow UI https://docs.telemetry.mozilla.org/concepts/airflow_gotchas.html new 1741aaa6
datasets/active_profiles.md Flag pipeline as likely retired/archived https://github.com/mozilla/bigquery-etl/tree/HEAD/sql/moz-fx-data-shared-prod/telemetry_derived mozilla/telemetry-airflow#437 https://github.com/mozilla/telemetry-airflow/tree/HEAD/dags new b07dc198
datasets/batch_view/telemetry_aggregates/reference.md Add decommission notice for telemetry_aggregates dataset https://mozilla.github.io/telemetry-dashboard/new-pipeline/evo.html new 8b6ff4e7
datasets/jetstream.md Point to metric-hub for config-push trigger, note archive https://github.com/mozilla/jetstream-config/blob/main/README.md https://github.com/mozilla/metric-hub/blob/main/jetstream/README.md new 7e83e5e4
datasets/jetstream.md Document days28 and preenrollment analysis windows https://github.com/mozilla/experimenter-docs/blob/main/docs/data-analysis/jetstream/operations.md https://github.com/mozilla/jetstream/blob/main/jetstream/analysis.py https://github.com/mozilla/metric-hub/blob/main/lib/metric-config-parser/metric_config_parser/metric.py new 11797fdc
datasets/new_data.md Name Glean as the required path for new instrumentation https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/start/adding-a-new-probe.html https://mozilla.github.io/glean/book/user/adding-glean-to-your-project.html https://mozilla.github.io/glean/book/user/integrating-glean-for-product-managers.html new 3429e401
datasets/non_desktop/day_2_7_activation/reference.md Note table is deprecated and deleted mozilla/bigquery-etl#9957 new b24c0662
datasets/non_desktop/day_2_7_activation/reference.md Mark code reference as removed from bigquery-etl https://github.com/mozilla/bigquery-etl/blob/main/GRAVEYARD.md mozilla/bigquery-etl#9957 new 453ddd2f
datasets/search.md Note new parallel Glean-based search pipeline https://github.com/mozilla/bigquery-etl/blob/131aa993034a53540fca26627fc920d82a18f96b/sql/moz-fx-data-shared-prod/search_derived/search_clients_daily_glean_v1/README.md new f757cb0b
metrics/dimensions.md Note that metric-hub is now the canonical dimension source https://github.com/mozilla/metric-hub/blob/main/definitions/README.md new 1c789bff
metrics/dimensions.md Replace STMO query link bullet with metric-hub reference https://github.com/mozilla/metric-hub/blob/main/definitions/README.md new 82896ce0
metrics/metrics.md Document active_users_aggregates, mobile_engagement, mobile_retention tables https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/telemetry/active_users_aggregates/metadata.yaml https://github.com/mozilla/metric-hub/blob/9fb9ab647f1850ddd3d1c113f393cb8e5eefeedb/definitions/multi_product.toml new 41a969f3
metrics/policy.md Note Metric Hub as canonical metric metadata source https://github.com/mozilla/data-docs/blob/main/src/concepts/metric_hub.md https://github.com/mozilla/metric-hub new 2cf1b290
metrics/policy.md Mention Confluence Metrics Inventory as supporting source https://github.com/mozilla/data-docs/blob/main/src/metrics/metrics.md new 1c349cb8
metrics/policy.md Add deprecate-not-delete metric lifecycle policy https://github.com/mozilla/data-docs/blob/main/src/concepts/metric_hub.md new e68e192b

Not included: 0 findings that need a banner, a new section (docs bug), or facts the research couldn't source.

doc-correctness added 22 commits October 15, 2026 13:22
…from nightly to CircleCI/Jenkins

Finding-Id: df663f5a96cc49298045ee91bf335174
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/telemetry-airflow/blob/main/dags/bqetl_artifact_deployment.py
…_tables task with publish_tables_and_views

Finding-Id: dab451274d604f7dbd99787209d652c0
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/telemetry-airflow/blob/main/dags/bqetl_artifact_deployment.py
…ws task with publish_tables_and_views

Finding-Id: 55db0524531f4950ba5cd453bb9fc45a
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/telemetry-airflow/blob/main/dags/bqetl_artifact_deployment.py
….yml/bqetl) monitoring setup

Finding-Id: 96558af2ce754788ba150115ac159796
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/bigquery-etl/blob/main/bigquery_etl/cli/monitoring.py
…MO for new dashboards

Finding-Id: 0957007de7b74bd894e4b69fd857285c
Reviewed: no (this PR is the review)
Source: https://docs.telemetry.mozilla.org/introduction/tools
Source: https://docs.telemetry.mozilla.org/tools/stmo
…s in Airflow UI

Finding-Id: 1741aaa69d3b47e9b1451824efa3a385
Reviewed: no (this PR is the review)
Source: https://docs.telemetry.mozilla.org/concepts/airflow_gotchas.html
…on notice for telemetry_aggregates dataset

Finding-Id: 8b6ff4e7d00c4035b9a4710314a27f3a
Reviewed: no (this PR is the review)
Source: https://mozilla.github.io/telemetry-dashboard/new-pipeline/evo.html
…eprecated and deleted

Finding-Id: b24c0662b36349c59adca73d9c9585a1
Reviewed: no (this PR is the review)
Source: mozilla/bigquery-etl#9957
…ence as removed from bigquery-etl

Finding-Id: 453ddd2fecd14f44a457eb5682a3da79
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/bigquery-etl/blob/main/GRAVEYARD.md
Source: mozilla/bigquery-etl#9957
…nsion source

Finding-Id: 1c789bff80a74a869bb3dc401440f2fc
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/metric-hub/blob/main/definitions/README.md
… reference

Finding-Id: 82896ce017684d97a5d30cce6521db7e
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/metric-hub/blob/main/definitions/README.md
… source

Finding-Id: 1c349cb8540c48138fcc41e44a7ad83a
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/data-docs/blob/main/src/metrics/metrics.md
Finding-Id: e68e192b39624b899a5857aa38f00132
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/data-docs/blob/main/src/concepts/metric_hub.md

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant