| Index: docs/how-to-write-metrics.md | 
| diff --git a/docs/how-to-write-metrics.md b/docs/how-to-write-metrics.md | 
| index b5f8ed6cd17981a9520e06de8a8dd0436cb07648..84b6c66c3e59586d5ae66777ba2a446d8d02a702 100644 | 
| --- a/docs/how-to-write-metrics.md | 
| +++ b/docs/how-to-write-metrics.md | 
| @@ -169,17 +169,6 @@ histogram.addSample(number, {name: diagnostic}) | 
|  | 
|  | 
|  | 
| -### Environment Information Diagnostics | 
| - | 
| - * [TelemetryInfo](/tracing/tracing/value/diagnostics/telemetry_info.html): | 
| -   This is automatically attached to every Histogram produced by telemetry. | 
| -   Structurally, it's a class with explicit named fields. | 
| -   Conceptually, it contains information about the origins of the trace that was | 
| -   consumed by the metric that produced the Histogram, such as the benchmark | 
| -   name, story name, benchmark start timestamp, etc. | 
| -   Visually, TelemetryInfos are displayed as a table. | 
| - | 
| -    | 
|  | 
| ### Other Diagnostics | 
|  | 
| @@ -289,18 +278,18 @@ default options are as follows: | 
| metric would call `histogram.customizeSummaryOptions({percentile: [0.5]})`. | 
|  | 
|  | 
| -## How histogram-set-table Uses Merging and TelemetryInfo | 
| +## How histogram-set-table Uses Merging | 
|  | 
| -The histogram-set-table element uses the fields of TelemetryInfo, along with the | 
| -merging capabilities of Histograms, to allow dynamic, hierarchical | 
| -organization of histograms: | 
| +The histogram-set-table element uses the predefined | 
| +[HistogramGroupings](/tracing/tracing/value/histogram_set.html), along with the | 
| +merging capabilities of Histograms, to allow dynamic, hierarchical organization | 
| +of histograms: | 
|  | 
| -* TelemetryInfo has mostly string/number (story name, story/set repeat count, | 
| -  etc.) fields and one dict field that specifies the names of any story grouping | 
| -  keys together with their histogram. | 
| +* Predefined HistogramGroupings specify how to find the benchmark, story, etc. | 
| +  that produced the Histogram. | 
| * After loading histograms, histogram-set-table computes categories to be | 
| displayed by the groupby picker at the top of the UI: | 
| -  * Categories are fields of TelemetryInfo that have more than one value across | 
| +  * Categories are HistogramGroupings that have more than one value across | 
| all histograms in the HistogramSet. | 
| * Instead of having one category for all story grouping keys, each grouping | 
| individual grouping key may be listed as a category. For example, in Page | 
| @@ -310,5 +299,5 @@ organization of histograms: | 
| histograms from the bottom up. Expanding the rows of histogram-set-table, any | 
| leaf nodes are histograms that were loaded, and their ancestors are computed by | 
| merging. | 
| -* histogram-set-table uses the "label" property of TelemetryInfo to define the | 
| -  columns of the table. | 
| +* histogram-set-table uses the "label" HistogramGrouping to define the columns | 
| +  of the table. | 
|  |