1654384 - Improve the documentation around logarithmic bucketing

Status: RESOLVED WONTFIX

(Data Platform and Tools :: Glean: SDK, defect, P4)

Description

[Michael Droettboom [:mdroettboom]]

Just having the bucketing formula isn't quite enough for all readers to intuitively grasp what the bucketing means.

We could do some combination of:

1. Provide a table of all of the bucket ranges in an appendix.
2. Provide an interactive calculator (in the docs in Javascript) to show what bucket a value would fall in (particularly to see if two values would fall in the same bucket).
3. Provide an interactive plot.

Comment 1

[Jan-Erik Rediger [:janerik]]

To note: we have the histogram simulator that matches the bucketing on Desktop: https://telemetry.mozilla.org/histogram-simulator

Comment 2

[GitHub Bugzilla PR Linker]

Attachment: Link to GitHub pull-request: https://github.com/mozilla/glean/pull/1150

Comment 3

[Beatriz Rizental [:brizental]]

Untaking this for the moment. Interactive plot has been merged in this PR and

1. Provide a table of all of the bucket ranges in an appendix.
2. Provide an interactive calculator (in the docs in Javascript) to show what bucket a value would fall in (particularly to see if two values would fall in the same bucket).

still need to be addressed.

Comment 4

[Michael Droettboom [:mdroettboom]]

I think (2) isn't super necessary, now that we have the simulator. I was really just suggesting it as an easier first step.

(1) is still maybe nice-to-have, but less critical now that we have a simulator.

Comment 5

[Travis Long [:travis_]]

Closing this as stale