THE GITHTML FIELD GUIDE
Turn a desktop dashboard export into a linear reading document
Choose a reading sequence before styling the export: summary, evidence, interpretation, and next action. Put that sequence into the HTML source order, then use layout only as an enhancement. A dashboard's visual arrangement does not automatically become a usable report when its cards are stacked on a narrow screen.
Extract a narrative from the dashboard
Dashboards optimize for scanning several signals at once. Reports need to explain what those signals mean. Begin by identifying the question the reader is trying to answer. For a weekly service review, that might be whether reliability improved and what work remains. Select the relevant measurements instead of copying every card into the export.
Write a short summary that states the reporting period, the main change, and the important limitation. Then place supporting evidence in the order needed to understand that summary. A chart with no interpretation can leave the reader guessing whether a spike is expected, concerning, or irrelevant. Add the context that the live dashboard's regular users may already know.
Make source order authoritative
A two-column desktop composition may place related items next to each other while their HTML source order is very different. On a phone, or when using assistive technology, that mismatch can make the argument confusing. Arrange the source so each metric is followed by its explanation and caveat. Avoid relying on CSS ordering to repair a poorly organized document.
Remove visual instructions such as see the panel on the right. Refer to section names or link directly to the relevant heading. If a comparison requires two values to be considered together, present them in the same sentence or a small table. Do not assume that adjacent dashboard cards will remain adjacent in every reading environment.
Replace live controls with explicit context
A static export should identify the filters and date range that produced it. A disabled dropdown labeled Region does not communicate which region was selected. Replace it with text such as Region: North America. If the report includes a snapshot of a changing metric, label the capture time and avoid implying that the values are live.
- Write the document's central question in one sentence.
- Group each result with its interpretation and limitation.
- Record date ranges, units, filters, and data freshness as visible text.
- Read the source order without the grid styling to identify abrupt transitions.
- Confirm that the HTML contains the actual values rather than empty containers waiting for a JavaScript request.
Sources and further reading
AI-assisted writing with source-linked guidance and illustrative examples. Read our editorial approach or report a correction.