### Problem The CREDIT acronym is being used inconsistently across GitLab documentation. Some references omit values or incorrectly separate "Diversity, Inclusion and Belonging" (DIB) into individual components, leading to incomplete or inaccurate representations of our core values. **Example:** In `content/handbook/company/mission.md`, the values were listed as "collaboration, results, efficiency, diversity, inclusion and transparency" - omitting "Iteration" entirely and incorrectly separating DIB components. ### CREDIT Values (Canonical Reference) * **C**ollaboration * **R**esults * **E**fficiency * **D**iversity, Inclusion and Belonging * **I**teration * **T**ransparency **Source:** GitLab Values Handbook ### Scope of Work #### Phase 1: Audit (Week 1-2) * [x] Search handbook repository for all CREDIT value references * [ ] Identify patterns of incorrect usage: * Missing "Iteration" * "Inclusion" listed separately from "Diversity, Inclusion and Belonging" * Incomplete value lists * Inconsistent phrasing * [ ] Document all locations requiring updates in a spreadsheet/table * [ ] Check GitLab product documentation (docs.gitlab.com) * [ ] Review marketing materials and public-facing content #### Phase 2: Standardization (Week 2-3) * [ ] Define standard phrasing patterns: * **Full list format:** "collaboration, results, efficiency, diversity, inclusion and belonging, iteration, and transparency" * **Acronym format:** "CREDIT values" * **Individual DIB reference:** "Diversity, Inclusion and Belonging (DIB)" * [ ] Update style guide with CREDIT usage guidelines * [ ] Create reusable content snippets/partials for common references * [ ] Get approval from People Ops/Culture team #### Phase 3: Implementation (Week 3-4) * [x] Update `content/handbook/company/mission.md` (covered in !19299) * [ ] Update all identified locations from audit * [ ] Verify `/handbook/values/` canonical documentation is correct * [ ] Check and update onboarding materials * [ ] Review training and culture documentation * [ ] Update any templates or boilerplate text * [ ] Update README files and contribution guides #### Phase 4: Prevention (Week 4-5) * [ ] Add linting rule or CI check to catch incomplete CREDIT references * [ ] Document proper usage in contribution guidelines * [ ] Add to MR review checklist for handbook changes * [ ] Create automated tests for common patterns * [ ] Schedule quarterly audits ### Search Commands for Audit ```bash # Search for incomplete CREDIT references grep -rn "collaboration, results, efficiency, diversity, inclusion" content/handbook/ grep -rn "diversity, inclusion and transparency" content/handbook/ grep -rn "diversity, iteration and transparency" content/handbook/ # Search for CREDIT mentions grep -rn "CREDIT values" content/handbook/ grep -rn "CREDIT acronym" content/handbook/ # Search for individual value references that might be incomplete grep -rn "our values" content/handbook/ | grep -v "CREDIT" grep -rn "GitLab values" content/handbook/ # Search in docs repository grep -rn "collaboration, results, efficiency" doc/ ``` Copy to clipboard Copy to clipboard ### Expected Deliverables 1. Audit report with all locations requiring updates 2. Updated style guide section on CREDIT values 3. All identified instances corrected 4. CI/linting rules implemented 5. Documentation for future contributors ### Related * Merge Request: !19299 - Initial discovery and fix for mission.md * Handbook: Values * Discussion: \[Link to this MR discussion thread\] ### Labels `~documentation` `~handbook` `~values` `~CREDIT` `~consistency` `~audit` ### Priority **High** - This affects fundamental company values representation and brand consistency ### Assignee \[To be determined - suggest People Ops or Documentation team\] ### Due Date Target completion: 5 weeks from issue creation --- ## Corrected Code Suggestion for Current MR The current change in this MR is still incorrect. Here's the proper fix: ```suggestion - GitLab has a set of values for how GitLab team members strive to conduct themselves. We don't expect all companies to value collaboration, results, efficiency, diversity, inclusion and belonging, iteration, and transparency in the same way we do. As an open company, "everyone can contribute" is our default and [transparency](/handbook/values/#transparency) is our check and balance. Transparency means our handbook, issues, merge requests and product roadmap are online for everyone to see and contribute to.inclusion and belonging, , ``` This ensures all six CREDIT values are properly represented with DIB as a complete unit.