Track links to and from handbook pages
Problem to solve
The GitLab handbook has a vast amount of interconnected content. When making a change to one page, it's possible to negatively impact the relevance or structure of another page. For example, a page that links to a specific product strategy may lose the appropriate context if that strategy has changed since the original link was created. Or put another way, take two hypothetical pages:
1. Don't be evil
2. Make the world a better place
3. Make money
... as illustrated by our most important company value, [Don't be evil](link-to-page-1)...
Then Page 1 gets edited...
1. Make money
2. Make the world a better place
3. Try not to be evil
Page 2 doesn't seem so relevant now and it would be confusing to the reader.
Proposal
The best way to ensure that the impact of content changes on a handbook page is considered for every change is to be able to visualize the connections between pages. The author should be able to tell what pages are linking back to the content that's being edited as well as what pages are being linked to from the current page.
But to get there, we need to build that reference map first.
Reference/Inspiration
- A discussion around Roam here (gitlab-org issue link) points out some interesting approaches to visualizing linked content