Improve documentation link messaging on settings pages
Problem to solve
With the recent design improvement to the setting pages (https://gitlab.com/gitlab-org/gitlab-ce/issues/49417#note_99381056), we replaced help icons with links to documentation.
Currently, this is communicated as "Learn more about badges." and a mix of help icons.
Messaging consistent with the Pajamas guidelines will only be more beneficial to the user, and being consistent with our tone will uphold the consistency of our identity.
Proposal
Update messaging to meet the Pajamas guidelines for Helping Users: https://design.gitlab.com/usability/helping-users/#formatting-help-content
- Instead of
Learn more about badges
... - use
What are badges?
orMore information
, depending on the UI Text. - Consider replacing
?
with actual links because they are not tooltips. - Ensure description have proper punctuation.
Links / references
Edited by Michael Le