Q3FY22 KR: Settings UI updates (AMER/APAC)
Part of Q3FY22 KR: Improve the UX of Settings pages by finalizing UI text polish.
The UI text on GitLab Settings pages needs to be reviewed and edited for wordiness, passive voice, inconsistency, clarity, and future tense.
The GitLab application is based on the Pajamas UI text guidance voice and tone requirements. Familiarize yourself with the guidelines in the Content section of Pajamas.
Field names, button names, or other UI element labels shouldn't be changed unless their current state causes significant product use issues. Be sure to update product documentation if UI elements change in this manner.
Background
- Every Technical Writer will review UI text for the remaining Settings sections that haven't yet been reviewed or revised.
- After completing their review, Technical Writers will make relevant updates to their assigned sections' wording within the code.
- Issues will have been created for each Settings section that needs a review by the time of the review.
OKR Process
- TWs should self-assign at least X issues throughout the quarter.
- Use the UI-text template in the Technical Writing project.
- Assign yourself to the issue created for the section you're working on, and add your name to the following table for that section.
- One TW (to be determined by @cnorris) will throughout the quarter do a holistic review of the Settings UI text. This ensures that changes over previous quarters all work together as a collective whole throughout the application.
Settings to do
-
Admin Area > General > Terms of Service and Privacy Policy - @marcel.amirault (gitlab#330185 (closed)) -
Project > Integrations > Datadog - @aqualls (gitlab#335234 (closed)) -
Admin Area > General > Sign-in restrictions - @rdickenson (gitlab#330184 (closed)) -
Admin Area > Network > Issue Rate Limits - @ngaskill (gitlab#330226 (closed)) -
Admin Area > Network > Incident Management Limits - @marcel.amirault (gitlab#330229 (closed)) -
Admin Area > Network > Import/Export Rate Limits - @marcel.amirault (gitlab#330228 (closed)) -
Admin Area > General > Maintenance mode - @rdickenson (gitlab#330189 (closed)) -
Admin Area > Network > Notes Rate Limits - @marcel.amirault (gitlab#330227 (closed)) -
Admin Area > Network > Package Registry Rate Limits - @marcel.amirault (gitlab#330221 (closed)) -
Admin Area > Network > User and IP Rate Limits - @marcel.amirault (gitlab#330220 (closed)) -
Admin Area > General > Web terminal - @aqualls (gitlab#330187 (closed)) -
Group > General > Templates - @aqualls (gitlab#330161 (closed)) -
Admin Area > General > Account and limit - @rdickenson (gitlab#330182 (closed)) -
Admin Area > Reporting > Abuse reports - @rdickenson (gitlab#330211 (closed)) -
Group > General > Compliance frameworks - @eread (gitlab#330159 (closed)) -
Admin Area > Reporting > Spam and Anti-bot Protection - @aqualls (gitlab#330210 (closed)) -
Admin Area > Network > Performance optimization - @rdickenson (gitlab#330219 (closed)) -
Admin Area > Metrics and profiling > Pseudonymizer data collection - @aqualls (gitlab#330218 (closed)) -
Admin Area > Network > Protected Paths - @eread (gitlab#330225 (closed)) -
Group > Usage Quotas > Top-level page - @rdickenson (gitlab#330176 (closed)) -
Project > Usage Quotas - @rdickenson (gitlab#343613 (closed))
Links and references
Edited by Diana Logan