Skip to content

Doc fixes (2026-10-24) - #922

Draft
scholtzan wants to merge 19 commits into
mainfrom
doc-fixes-2026-10-24
Draft

scholtzan wants to merge 19 commits into
mainfrom
doc-fixes-2026-10-24

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/event_pipeline.md Add events_daily dataset bullet with mozfun.event_analysis note https://docs.telemetry.mozilla.org/datasets/bigquery/events_daily/reference https://github.com/mozilla/bigquery-etl/blob/d481c145cffa1fa5cefe0324a47eee4cba963dfe/sql/mozfun/event_analysis/README.md https://github.com/mozilla/bigquery-etl/blob/main/sql_generators/glean_usage/events_stream.py new b93e0ecf
concepts/segments.md Note newer clients_last_seen_v2 view and its added columns https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/telemetry/clients_last_seen_v2/view.sql new a7235663
concepts/terminology.md Note Looker as preferred over STMO for dashboards https://docs.telemetry.mozilla.org/introduction/tools new 2917b69b
contributing/structure.md List additional src/ subfolders now present in the repo https://github.com/mozilla/data-docs/tree/HEAD/src https://github.com/mozilla/data-docs/tree/HEAD/src/contributing https://github.com/mozilla/data-docs/tree/HEAD/src/historical https://github.com/mozilla/data-docs/tree/HEAD/src/metrics https://github.com/mozilla/data-docs/tree/HEAD/src/reference new 0a9fd129
cookbooks/clients_last_seen_bits.md Mention additional undocumented bit pattern fields https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/telemetry_derived/clients_last_seen_v2/schema.yaml new fc7f82b6
cookbooks/data_monitoring/intro.md Warn against ad hoc local bigconfig apply/deploy https://github.com/mozilla/bigquery-etl/blob/main/docs/reference/bigconfig.md new c9510106
cookbooks/live_data.md Update live table latency characterization to under 1 hour https://docs.telemetry.mozilla.org/cookbooks/live_data new cba81bac
cookbooks/looker/event_counts_explore.md Mention new glean_event_counts explore for Firefox Desktop https://github.com/mozilla/looker-hub/blob/main/firefox_desktop/explores/glean_event_counts.explore.lkml new 64bca86a
cookbooks/looker/performance_caching.md Note 24h default max_cache_age on generated datagroups https://github.com/mozilla/lookml-generator/blob/main/generator/views/datagroups.py new cfa846fe
datasets/batch_view/addons/reference.md Document partitioning, filter requirement, expiration, clustering https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/telemetry_derived/addons_v2/metadata.yaml new 4710e569
datasets/batch_view/addons/reference.md Update DAG definition source to dags.yaml https://github.com/mozilla/bigquery-etl/blob/main/dags.yaml new a947d94d
datasets/batch_view/clients_daily/reference.md Note clients_daily view now joins in event-ping/crash data https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/telemetry/clients_daily/view.sql new bb3dfd11
datasets/search/client_ltv/reference.md Note model replaced by Markov-chain state framework https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/firefox_desktop_derived/ltv_states_v1/query.sql https://github.com/mozilla/bigquery-etl/blob/main/sql/mozfun/ltv/desktop_states_v1/udf.sql new 19767b23
datasets/search/search_clients_last_seen/reference.md Add mobile search clients last seen dataset section https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/search_derived/mobile_search_clients_last_seen_v1/metadata.yaml new cfcd79ea
metrics.md Point obsolete warning to new Metrics page and GUD https://docs.telemetry.mozilla.org/metrics/metrics https://mozilla.github.io/gud/ new fcdf76c7
metrics.md Note canonical definitions now live in Metric Hub/BigQuery https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/telemetry/active_users_aggregates/schema.yaml https://github.com/mozilla/metric-hub/tree/HEAD/definitions new 14ad00d3
metrics.md Note legacy retention metric deprecated in favor of Retained (DAU) https://mozilla.github.io/metric-hub/default_configs/firefox_desktop/ new f97d69aa
metrics/metrics.md Update Day 2-7 activation definition to include search requirement https://github.com/mozilla/bigquery-etl/blob/main/sql_generators/mobile_kpi_support_metrics/templates/new_profile_activation_clients.view.sql new 66294436
tools/spark.md Note built-in connector on Dataproc 2.1+ and metadata upgrade flag https://github.com/GoogleCloudDataproc/spark-bigquery-connector new 2b2ed076

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

doc-correctness added 19 commits October 24, 2026 13:13
…oards

Finding-Id: 2917b69b6b804b7290096dca602ad11c
Reviewed: no (this PR is the review)
Source: https://docs.telemetry.mozilla.org/introduction/tools
…ig apply/deploy

Finding-Id: c95101060a00476f9fbf96b90879c583
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/bigquery-etl/blob/main/docs/reference/bigconfig.md
… under 1 hour

Finding-Id: cba81bac932a41c78549d21d7e3b9afa
Reviewed: no (this PR is the review)
Source: https://docs.telemetry.mozilla.org/cookbooks/live_data
…nts explore for Firefox Desktop

Finding-Id: 64bca86a722440ec9e24c18da6aba5c7
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/looker-hub/blob/main/firefox_desktop/explores/glean_event_counts.explore.lkml
…ge on generated datagroups

Finding-Id: cfa846feb0e945e484b1c0e220a3c504
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/lookml-generator/blob/main/generator/views/datagroups.py
…r requirement, expiration, clustering

Finding-Id: 4710e569d4294d30ad849106c310f4dd
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/telemetry_derived/addons_v2/metadata.yaml
… to dags.yaml

Finding-Id: a947d94d402f49dd8bef5340b10e8cbc
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/bigquery-etl/blob/main/dags.yaml
…ew now joins in event-ping/crash data

Finding-Id: bb3dfd113e1243d6afdb15286ede8f93
Reviewed: no (this PR is the review)
Source: https://github.com/mozilla/bigquery-etl/blob/main/sql/moz-fx-data-shared-prod/telemetry/clients_daily/view.sql
Finding-Id: fcdf76c7c5b84fe7aaff074c97de61ab
Reviewed: no (this PR is the review)
Source: https://docs.telemetry.mozilla.org/metrics/metrics
Source: https://mozilla.github.io/gud/
…ned (DAU)

Finding-Id: f97d69aafcc84ebfa1598882c20cbbe6
Reviewed: no (this PR is the review)
Source: https://mozilla.github.io/metric-hub/default_configs/firefox_desktop/
… upgrade flag

Finding-Id: 2b2ed076bc1a42208a36da82f0dc07ed
Reviewed: no (this PR is the review)
Source: https://github.com/GoogleCloudDataproc/spark-bigquery-connector

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