Link implementation issues to documentation

This an actionable insight from the Code Review FY21-Q2 Category Maturity Scorecard research (insight).

What

In research we identified that, sometimes, when users search the web for help on a specific topic, one of the first search results links to the implementation issue of the feature, and not the documentation. Users then spend some time trying to grasp what that web page is about, and where is the information that can help them understand how to proceed/use the feature.

This was noticed when researching the Code Owner approvals feature, but we can safely assume that this also happens to other features/topics.

Search result	Issue

Why

When users get to this point, of searching the web for answers, it’s because they’ve gone past their “patience” point and have given up on the UI. If the first search result they click on is an implementation issue on GitLab.com, it will most likely add to their frustration and confusion.

How

1. Find out which top features usually have implementation issues as one of the first 5 search results. Or, alternatively, find out the top visited documentation pages for specific features.
2. For the corresponding implementation issues, add a very visible information block at the top, clearly calling out the documentation.