Correct structure of Telemetry cross-references
Problem to solve
The Telemetry documentation currently uses several cross-reference techniques which go against the GitLab conventions:
- Table of contents of each sub-page are listed on the Telemetry overview page
- "More useful links" section is at the top, but should be moved to the bottom, if it's to remain.
In addition, it would improve this page to introduce Usage Ping and Snowplow, using those as an opportunity to link to their own pages.
Further details
N/A
Proposal
- Remove the table of contents entries of the sub-pages.
- Add to the page's introduction mention of Usage Ping and Snowplow, and include links to their pages in this section.
- Review the "More useful links" section and, if it's judge to be useful, move it to the end of the page.
Who can address the issue
Technical writer
Other links/references
N/A
Edited by Russell Dickenson