Combine multiple documentation pages that define and explain Sessions
Open, Needs TriagePublic
Actions

Assigned To

None

Authored By

	TBurmeister
	Apr 24 2024, 5:00 PM

Description

There are multiple pages of documentation that provide conceptual and reference information about the concept of a "session" and how it is handled/measured, both generally and in specific WMF data sources. These documentation pages should be combined or deduplicated, and a single source of truth page should be linked to from the related Glossary entries in DataHub. Currently, https://wikitech.wikimedia.org/wiki/Analytics/Sessions is linked to from the DataHub glossary entries, but the wiki page hasn't had a meaningful content edit since 2023, and it isn't easily discoverable from related documentation in the Data_Lake/Traffic subpages nor from the related documentation on Meta-Wiki.

Related Objects
Search...

Status	Assigned	Task
Open	OSefu-WMF	T369191 Metric Documentation Updates and Improvements
Open	Mayakp.wiki	T369226 [MI 1] Reporting, Data Visualization, and Data Communications
In Progress	None	T379904 Consolidate and and deprecate metric definition pages
Open	None	T363354 Combine multiple documentation pages that define and explain Sessions

Event Timeline

TBurmeister created this task.Apr 24 2024, 5:00 PM

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptApr 24 2024, 5:00 PM

• VirginiaPoundstone moved this task from Incoming to Pipelines Backlog on the Test Kitchen board.May 3 2024, 3:46 PM

phuedx updated the task description. (Show Details)Jun 4 2024, 9:10 AM

I suspect that it's scope creep but it would be good to link to the single source of truth about sessions from the corresponding properties in the Metrics Platform schemas:

Property	Definition
`performer.session_id`	https://gerrit.wikimedia.org/g/schemas/event/secondary/+/a30c0460895ff97a69aefb3709d8203d5ca6969a/jsonschema/fragment/analytics/product_metrics/common/current.yaml#274
`performer. active_browsing_session_token`	https://gerrit.wikimedia.org/g/schemas/event/secondary/+/a30c0460895ff97a69aefb3709d8203d5ca6969a/jsonschema/fragment/analytics/product_metrics/web/current.yaml#171