Designing Openly for Everyone: Meet Codex! ![rw-book-cover](https://i.ytimg.com/vi/oNuj40dElaI/maxresdefault.jpg) ๐Ÿ”— **Source:** [Designing Openly for Everyone: Meet Codex!](https://www.youtube.com/watch?v=oNuj40dElaI) > [!note]+ Document Notes > tags: [design-systems, accessibility, open-source, internationalization, wikipedia, ux-design, inclusive-design, collaboration] > author: Barbara Martinez > source: YouTube > reference: https://www.youtube.com/watch?v=oNuj40dElaI > date created: 2025-10-30 07:30 > > # ๐Ÿท๏ธ Title: Designing Openly for Everyone: Meet Codex - Wikipedia's Design System > <!-- deep-read:sections start --> ## ๐Ÿงฐ Action Inbox - [H1] Join Codex Fabricator board for open collaboration โ€” QR code provided #design-systems - [H2] Test components across multiple languages and use cases โ€” internationalization requirement #accessibility - [H3] Subscribe to Codex Telegram channel for community discussions โ€” new community space #community ## ๐Ÿงญ Table of Contents - [๐Ÿ“ Summary](#-summary) - [๐Ÿ“– Main Content](#-main-content) - [๐Ÿ—’๏ธ Notes](#๏ธ-notes) - [๐Ÿ“š References](#-references) - [๐Ÿ—ฃ๏ธ Paraphrase](#๏ธ-paraphrase) - [๐Ÿ“ฐ Newsletter](#-newsletter) - [โœ… Action Items](#-action-items) - [๐Ÿงช Hypotheses](#-hypotheses) - [๐Ÿ“Š Methodology](#-methodology) - [โ“ Questions](#-questions) - [๐Ÿ”ฎ Future Research](#-future-research) - [๐Ÿ’ก Implications](#-implications) - [๐Ÿง  Learning Styles Assessment](#-learning-styles-assessment) - [๐Ÿ“Š Accessibility Assessment](#-accessibility-assessment) - [๐ŸŒ DEIB Assessment](#-deib-assessment) - [โœ… Logical Validity](#-logical-validity) - [๐Ÿ›ก๏ธ DARVO Analysis](#-darvo-analysis) - [๐ŸŽฏ Conclusion](#-conclusion) ### ๐Ÿ”— References - [Codex Design System](https://doc.wikimedia.org/codex/) - [Wikimedia Fabricator](https://phabricator.wikimedia.org/) ## ๐Ÿ“ Summary - Barbara Martinez presents Codex, Wikipedia's open-source design system serving over 1 billion users across 300+ languages - The system operates as a federated, community-driven project where volunteers and foundation staff collaborate openly through Fabricator - Key principles include accessibility-first design, comprehensive internationalization support, and building with the community rather than just for it - Demonstrates how open collaboration leads to stronger, more inclusive design systems despite added complexity - Provides concrete examples of accessibility improvements, internationalization challenges, and community-driven enhancements ## ๐Ÿ“– Main Content Codex represents a unique approach to design systems as Wikipedia's open, federated system built through community collaboration. Unlike traditional corporate design systems owned by single teams, Codex operates as a living conversation with global volunteers who contribute components, icons, and tokens. The system serves Wikimedia's massive scale - over 1 billion users across 300+ languages with diverse abilities, devices, contexts, and cultures. This complexity drives Codex's core principles: accessibility as baseline rather than checklist, comprehensive internationalization beyond simple translation, and radical openness in development processes. Key technical achievements include full right-to-left language support, localized icon variations (like bold/italic icons using "N" for Spanish "negita"), dark mode implementation with desaturated color palettes, and improved diff styles using multiple visual cues beyond color. The federated governance model manages contributions through Fabricator, Wikimedia's open task management system. ## ๐Ÿ—’๏ธ Notes #### โฑ๏ธ [00:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=0) โ€” [H1] Introduction: Codex as Wikipedia's Design System - Key idea: Codex is the design system powering all Wikipedia interactions - Evidence: "If you have ever clicked edit, read or do anything in Wikipedia, you probably have been playing with Codex" #### โฑ๏ธ [02:30](https://www.youtube.com/watch?v=oNuj40dElaI?t=150) โ€” [H2] Open Collaboration Philosophy - Key idea: Wikipedia builds with the community, not just for it - Evidence: "We build with the community not just for it. This means that we collaborate with thousands of volunteers" #### โฑ๏ธ [04:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=240) โ€” [H2] Scale and Complexity Requirements - Key idea: Codex serves over 1 billion users across diverse contexts - Evidence: "Wikimedia serves over a billion users for different languages, different devices, different abilities, different contexts and different cultures" #### โฑ๏ธ [05:30](https://www.youtube.com/watch?v=oNuj40dElaI?t=330) โ€” [H1] Federated Design System Model - Key idea: No single team owns Codex; it's truly collaborative - Evidence: "Codex is a federated design system. This means that no single team owns it" #### โฑ๏ธ [07:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=420) โ€” [H2] Fabricator as Collaboration Platform - Key idea: All design and development tasks managed openly in Fabricator - Evidence: "Anyone can jump in Fabricator's task and ask questions, comment, provide feedback, suggest changes" #### โฑ๏ธ [08:45](https://www.youtube.com/watch?v=oNuj40dElaI?t=525) โ€” [H3] Type Head Search Component Example - Key idea: Mobile usability improvements driven by community feedback - Evidence: "We detected with Wikipedia users that search input was not working properly for small devices" #### โฑ๏ธ [10:15](https://www.youtube.com/watch?v=oNuj40dElaI?t=615) โ€” [H3] External Link Icon Redesign - Key idea: Small visual changes can have massive impact at scale - Evidence: "Small change that makes a big difference because we use this at 12 pixels" #### โฑ๏ธ [12:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=720) โ€” [H3] Community Onboarding Improvements - Key idea: Created "good first tasks" board for volunteers with varying expertise - Evidence: "We created good first tasks for Codex so everyone can join and find tasks that fit their expertise" #### โฑ๏ธ [13:30](https://www.youtube.com/watch?v=oNuj40dElaI?t=810) โ€” [H1] Accessibility as Baseline Mission - Key idea: Accessibility isn't a checklist but the foundation of the entire system - Evidence: "Accessibility is not just a checklist in Codex, it's the baseline of our mission" #### โฑ๏ธ [15:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=900) โ€” [H2] Situational Accessibility Examples - Key idea: Accessibility benefits everyone, not just users with permanent disabilities - Evidence: "Someone holding a baby with one hand and using mobile with the other reading Wikipedia" #### โฑ๏ธ [17:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=1020) โ€” [H3] Dark Mode Implementation - Key idea: Dark mode required comprehensive color palette review and desaturation - Evidence: "We needed to desaturate some colors, especially the progressive blue ones for buttons and links" #### โฑ๏ธ [19:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=1140) โ€” [H3] Diff Styles Accessibility Improvement - Key idea: Multiple visual cues replace color-only differentiation - Evidence: "We reinforce adding and removing with visual clues like icons and borders, not always relying on colors" #### โฑ๏ธ [21:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=1260) โ€” [H1] Internationalization Beyond Translation - Key idea: Supporting 300+ languages requires comprehensive cultural adaptation - Evidence: "Codex is built for more than 300 languages - this includes full right-to-left support and icon flipping" #### โฑ๏ธ [23:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=1380) โ€” [H3] Localized Icon Examples - Key idea: Icons must reflect local language conventions, not just English - Evidence: "Bold in English but in Spain we say 'negrita' so we need an 'N' icon" #### โฑ๏ธ [25:30](https://www.youtube.com/watch?v=oNuj40dElaI?t=1530) โ€” [H2] Text Length Variation Challenges - Key idea: Components must work across languages with vastly different text lengths - Evidence: "Menu might work for English but what if used in Chinese or Japanese where text is much shorter?" ## ๐Ÿ“š References - [Codex Design System Documentation](https://doc.wikimedia.org/codex/) - [Wikimedia Fabricator Task Board](https://phabricator.wikimedia.org/) - [Wikipedia Foundation](https://wikimediafoundation.org/) - [Codex Telegram Channel](https://t.me/codex_design_system) ## ๐Ÿ—ฃ๏ธ Paraphrase - Codex operates as Wikipedia's federated design system where global volunteers collaborate with foundation staff through open processes, serving over 1 billion users across 300+ languages with accessibility-first principles - The system demonstrates how open collaboration creates stronger, more inclusive design outcomes despite increased complexity, with real community feedback driving improvements like mobile search enhancements and accessible diff styles - Internationalization extends far beyond translation to include right-to-left reading support, culturally appropriate icons, and flexible components that accommodate dramatic text length variations across languages ## ๐Ÿ“ฐ Newsletter **Wikipedia's Open Design System Offers Lessons for WordPress Community** The Wikimedia Foundation's approach to building Codex - their design system serving over 1 billion users - provides valuable insights for WordPress's community-driven development model. What makes Codex unique isn't just its scale, but its federated governance model. No single team owns the system. Instead, volunteers and foundation staff collaborate openly through Fabricator (their equivalent to WordPress Trac), where anyone can contribute components, provide feedback, or suggest improvements. Key takeaways for WordPress developers: - **Accessibility as baseline**: Rather than treating accessibility as a checklist, Codex embeds it as the foundation of every component - **Internationalization first**: Supporting 300+ languages means designing flexible components that work across dramatic cultural and text-length variations - **Community-driven priorities**: All new features emerge from real user needs documented in public tasks The system's approach to "good first tasks" for volunteers and open task management through Fabricator mirrors WordPress's own community contribution model, but with more structured onboarding. Resources: [Codex Design System](https://doc.wikimedia.org/codex/), [Wikimedia Fabricator](https://phabricator.wikimedia.org/), [Learn WordPress](https://learn.wordpress.org/), [Developer Docs](https://developer.wordpress.org/) ## โœ… Action Items #### DevRel - Developer advocacy: Present Codex model at WordCamp design track talks - Education: Create workshops comparing federated vs centralized design system governance - Developer experience: Document how WordPress core could adopt similar accessibility-first component development - Community management: Establish "good first tasks" boards for WordPress design contributions #### WordPress - Core: Evaluate federated design system governance models for WordPress component library - Design: Research accessibility-first component development processes from Codex - Community: Create structured onboarding for design system contributors similar to Codex model - Documentation: Document internationalization requirements for WordPress components using Codex examples - Accessibility: Implement multi-cue visual differentiation (icons + borders + color) for WordPress admin interfaces - Polyglots: Study Codex's approach to localized icons and cultural adaptation beyond translation ## ๐Ÿงช Hypotheses - Open, federated design system governance produces more accessible and internationally viable components than centralized ownership models - Community-driven component development through public task management leads to better real-world usability than internal team decisions - Accessibility-first design principles scale more effectively across diverse user contexts than retrofitted accessibility features - Multi-language design systems require cultural adaptation at the component level, not just translation at the content level ### ๐Ÿ“Š Methodology - Comparative analysis of federated vs centralized design system governance outcomes across open source projects - User testing of accessibility features across different cultural contexts and temporary disability scenarios - Component usage analysis comparing community-contributed vs internally-developed elements - Cross-cultural icon recognition studies for interface elements ### โ“ Questions - How could WordPress adopt federated design system governance while maintaining core stability and backwards compatibility? - What specific processes enable effective collaboration between volunteers and professional designers in open source design systems? - How do community-driven accessibility improvements compare to professional UX audit recommendations in terms of real-world impact? ### ๐Ÿ”ฎ Future Research - Analysis of other open source projects using federated design system models - Investigation of automated accessibility testing integration in collaborative design workflows - Study of internationalization tooling for component-level cultural adaptation ### ๐Ÿ’ก Implications - Practice: Open source projects need structured processes for design system collaboration, not just development contribution - Policy: Accessibility regulations should consider community-driven compliance processes alongside professional auditing - Education: Design system education must include cross-cultural and multi-language considerations from the start - Funding: Federated design systems require different resource allocation models than traditional centralized teams ### ๐Ÿง  Learning Styles Assessment Reading level estimate: 12th grade (complex technical vocabulary with concrete examples) #### ๐Ÿ‘€ Visual learners - Present: Component examples, before/after comparisons, dark mode demonstrations - Improve: Architecture diagrams of federated governance model, contribution workflow visuals #### ๐Ÿ”Š Aural learners - Present: 27-minute presentation with clear verbal explanations - Improve: Audio summary highlighting key collaboration processes #### ๐Ÿ—ฃ๏ธ Verbal learners - Present: Clear definitions of federated design systems, accessibility principles, internationalization - Improve: Glossary of technical terms, analogy-driven explanations of governance models #### ๐Ÿงฉ Kinesthetic learners - Present: QR codes for immediate access to Fabricator and Telegram - Improve: Hands-on workshop guides for contributing to design systems #### ๐Ÿง  Logical learners - Present: Clear progression from problem to solution, concrete examples with outcomes - Improve: Decision trees for contribution processes, metrics on community impact #### ๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘ Social learners - Present: Emphasis on community collaboration, volunteer engagement - Improve: Discussion prompts for design system governance, peer review processes #### ๐Ÿง˜โ€โ™€๏ธ Solitary learners - Present: Self-directed exploration through provided links and resources - Improve: Individual reflection questions on design system philosophy #### ๐ŸŒฟ Naturalistic learners - Present: Examples of organic community growth and ecosystem thinking - Improve: Analogies to natural systems and collaborative ecosystems ### ๐Ÿ“Š Accessibility Assessment #### Screen reader semantics - Present: Clear heading structure in presentation, descriptive component examples - Improve: Alt text for component screenshots, ARIA labels in code examples #### Keyboard navigation - Present: Discussion of keyboard navigation improvements in components - Improve: Demonstration of keyboard-only component interaction #### Contrast and readability - Present: Dark mode implementation with desaturated colors for better contrast - Improve: Specific contrast ratio examples, readability metrics #### Text resizing and reflow - Present: Discussion of responsive component behavior - Improve: Examples of component behavior at 200% zoom #### Media and captions - Present: Video presentation with clear audio - Improve: Full transcript with timestamps, downloadable captions #### Forms and interactions - Present: Search component accessibility improvements - Improve: Interactive examples of accessible form validation ### ๐ŸŒ DEIB Assessment #### Cultural breadth - Present: Extensive discussion of 300+ language support, cultural icon adaptation - Improve: More specific examples from non-Western cultures #### Inclusive language - Present: Clear, jargon-free explanations with technical terms defined - Improve: Avoid assumptions about cultural contexts #### Neurodiversity support - Present: Consistent presentation structure, clear section breaks - Improve: Content warnings for complex technical concepts #### Representation - Present: Global volunteer community emphasis, diverse use case examples - Improve: Include voices from different cultural backgrounds in examples #### Psychological safety - Present: Emphasis on welcoming community contribution - Improve: Explicit community guidelines, code of conduct references ### โœ… Logical Validity #### Strong reasoning - Deductive strength: Clear progression from open source principles to specific implementation practices - Inductive strength: Multiple concrete examples supporting broader claims about community-driven development - Causal reasoning: Direct links between community feedback and specific component improvements - Analogical strength: Effective comparison between traditional and federated design system models #### Fallacies - Appeal to numbers: "1 billion users" used as evidence of success without outcome metrics - False dichotomy: Implies open/federated is always better than closed/centralized without addressing tradeoffs #### Tone of voice - Overall tone: Enthusiastic but professional, emphasizing collaboration and inclusion with concrete technical examples ### ๐Ÿ›ก๏ธ DARVO Analysis - Deny: No denial patterns present - Attack: No attacks on alternative approaches - Reverse victim/offender: No victim/offender dynamics - Emotional cues and rhetoric: Positive framing of collaboration challenges as opportunities for improvement ## ๐ŸŽฏ Conclusion Barbara Martinez demonstrates how Wikipedia's Codex design system successfully implements federated, community-driven development at massive scale. The key insight is that open collaboration, while more complex, produces stronger and more inclusive systems when supported by structured processes like Fabricator task management and "good first tasks" for contributors. For WordPress and other open source projects, Codex offers a proven model for balancing community contribution with professional design standards, particularly in accessibility-first development and comprehensive internationalization. The practical next step involves evaluating how WordPress could adapt similar federated governance models while maintaining core stability. The broader implication suggests that design systems, like code, benefit from open source collaboration when proper infrastructure and community management support the process. ## ๐Ÿงฑ Refactor Appendix ### ๐Ÿ“š Literature Split Pad ### [H1] Federated design systems enable community-driven accessibility > [!quote] [Designing Openly for Everyone: Meet Codex](https://www.youtube.com/watch?v=oNuj40dElaI) by [[Barbara Martinez]] via [[YouTube]]. Published 2025-10-30. Accessed 2025-10-30. > "Codex is a federated design system. No single team owns it." Demonstrates alternative governance model where community and professional designers collaborate on accessibility improvements. [view highlight](https://www.youtube.com/watch?v=oNuj40dElaI#H1) #design-systems #accessibility ID:rw_federated_design ### [H2] Open collaboration produces stronger inclusive systems > [!quote] [Designing Openly for Everyone: Meet Codex](https://www.youtube.com/watch?v=oNuj40dElaI) > "Designing openly might take more effort but leads to systems that are more strong, sustainable and inclusive." Shows how community feedback improves real-world usability beyond internal team decisions. [view highlight](https://www.youtube.com/watch?v=oNuj40dElaI#H2) #community #inclusion ID:rw_open_collaboration ### [H3] Accessibility benefits extend beyond permanent disabilities > [!quote] [Designing Openly for Everyone: Meet Codex](https://www.youtube.com/watch?v=oNuj40dElaI) > "Someone holding a baby with one hand using mobile - this person will need interface easy to navigate with just one hand." Illustrates situational accessibility needs that affect all users temporarily. [view highlight](https://www.youtube.com/watch?v=oNuj40dElaI#H3) #accessibility #universal-design ID:rw_situational_access --- ### ๐Ÿ”– Atomic Split Pad (Zettel Candidates) #### [Z1] Federated governance distributes design system ownership - Scope: Open source projects with diverse contributor bases - Pointer: 05:30 timestamp on governance model - Links: [[Community-Driven-Development]] [[Design-System-Governance]] #### [Z2] Cultural adaptation requires component-level localization - Scope: International software with 100+ language support - Pointer: 23:00 timestamp on localized icons - Links: [[Internationalization]] [[Cultural-Design]] [[Icon-Systems]] #### [Z3] Accessibility improvements benefit all users situationally - Scope: Universal design principles in interface development - Pointer: 15:00 timestamp on situational disabilities - Links: [[Universal-Design]] [[Situational-Accessibility]] [[Inclusive-Design]] --- ### โœ๏ธ Fleeting Queue - [F1] Research WordPress design system governance models โ€” compare to Codex federated approach #fleeting #design-systems - [F2] Join Codex Telegram channel for community design system insights โ€” https://t.me/codex_design_system #fleeting #community - [F3] Document accessibility-first development processes โ€” extract from Codex methodology #fleeting #accessibility <!-- deep-read:sections end --> [[3. Resources/Readwise/Full Document Contents/Articles/Designing Openly for Everyone Meet Codex!|Full Document Contents]] ## Document Notes --- tags: #design-systems #accessibility #open-source #internationalization #wikipedia #ux-design #inclusive-design #collaboration author: Barbara Martinez source: YouTube reference: https://www.youtube.com/watch?v=oNuj40dElaI date created: 2025-10-30 07:30 --- # ๐Ÿท๏ธ Title: Designing Openly for Everyone: Meet Codex - Wikipedia's Design System ## ๐Ÿงฐ Action Inbox - [H1] Join Codex Fabricator board for open collaboration โ€” QR code provided #design-systems - [H2] Test components across multiple languages and use cases โ€” internationalization requirement #accessibility - [H3] Subscribe to Codex Telegram channel for community discussions โ€” new community space #community ## ๐Ÿงญ Table of Contents - [[#๐Ÿ“ Summary]] - [[#๐Ÿ“– Main Content]] - [[#๐Ÿ—’๏ธ Notes]] - [[#๐Ÿ“š References]] - [[#๐Ÿ—ฃ๏ธ Paraphrase]] - [[#๐Ÿ“ฐ Newsletter]] - [[#โœ… Action Items]] - [[#๐Ÿงช Hypotheses]] - [[#๐Ÿ“Š Methodology]] - [[#โ“ Questions]] - [[#๐Ÿ”ฎ Future Research]] - [[#๐Ÿ’ก Implications]] - [[#๐Ÿง  Learning Styles Assessment]] - [[#๐Ÿ“Š Accessibility Assessment]] - [[#๐ŸŒ DEIB Assessment]] - [[#โœ… Logical Validity]] - [[#๐Ÿ›ก๏ธ DARVO Analysis]] - [[#๐ŸŽฏ Conclusion]] ### ๐Ÿ”— References - [Codex Design System](https://doc.wikimedia.org/codex/) - [Wikimedia Fabricator](https://phabricator.wikimedia.org/) ## ๐Ÿ“ Summary - Barbara Martinez presents Codex, Wikipedia's open-source design system serving over 1 billion users across 300+ languages - The system operates as a federated, community-driven project where volunteers and foundation staff collaborate openly through Fabricator - Key principles include accessibility-first design, comprehensive internationalization support, and building with the community rather than just for it - Demonstrates how open collaboration leads to stronger, more inclusive design systems despite added complexity - Provides concrete examples of accessibility improvements, internationalization challenges, and community-driven enhancements ## ๐Ÿ“– Main Content Codex represents a unique approach to design systems as Wikipedia's open, federated system built through community collaboration. Unlike traditional corporate design systems owned by single teams, Codex operates as a living conversation with global volunteers who contribute components, icons, and tokens. The system serves Wikimedia's massive scale - over 1 billion users across 300+ languages with diverse abilities, devices, contexts, and cultures. This complexity drives Codex's core principles: accessibility as baseline rather than checklist, comprehensive internationalization beyond simple translation, and radical openness in development processes. Key technical achievements include full right-to-left language support, localized icon variations (like bold/italic icons using "N" for Spanish "negita"), dark mode implementation with desaturated color palettes, and improved diff styles using multiple visual cues beyond color. The federated governance model manages contributions through Fabricator, Wikimedia's open task management system. ## ๐Ÿ—’๏ธ Notes #### โฑ๏ธ [00:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=0) โ€” [H1] Introduction: Codex as Wikipedia's Design System - Key idea: Codex is the design system powering all Wikipedia interactions - Evidence: "If you have ever clicked edit, read or do anything in Wikipedia, you probably have been playing with Codex" #### โฑ๏ธ [02:30](https://www.youtube.com/watch?v=oNuj40dElaI?t=150) โ€” [H2] Open Collaboration Philosophy - Key idea: Wikipedia builds with the community, not just for it - Evidence: "We build with the community not just for it. This means that we collaborate with thousands of volunteers" #### โฑ๏ธ [04:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=240) โ€” [H2] Scale and Complexity Requirements - Key idea: Codex serves over 1 billion users across diverse contexts - Evidence: "Wikimedia serves over a billion users for different languages, different devices, different abilities, different contexts and different cultures" #### โฑ๏ธ [05:30](https://www.youtube.com/watch?v=oNuj40dElaI?t=330) โ€” [H1] Federated Design System Model - Key idea: No single team owns Codex; it's truly collaborative - Evidence: "Codex is a federated design system. This means that no single team owns it" #### โฑ๏ธ [07:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=420) โ€” [H2] Fabricator as Collaboration Platform - Key idea: All design and development tasks managed openly in Fabricator - Evidence: "Anyone can jump in Fabricator's task and ask questions, comment, provide feedback, suggest changes" #### โฑ๏ธ [08:45](https://www.youtube.com/watch?v=oNuj40dElaI?t=525) โ€” [H3] Type Head Search Component Example - Key idea: Mobile usability improvements driven by community feedback - Evidence: "We detected with Wikipedia users that search input was not working properly for small devices" #### โฑ๏ธ [10:15](https://www.youtube.com/watch?v=oNuj40dElaI?t=615) โ€” [H3] External Link Icon Redesign - Key idea: Small visual changes can have massive impact at scale - Evidence: "Small change that makes a big difference because we use this at 12 pixels" #### โฑ๏ธ [12:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=720) โ€” [H3] Community Onboarding Improvements - Key idea: Created "good first tasks" board for volunteers with varying expertise - Evidence: "We created good first tasks for Codex so everyone can join and find tasks that fit their expertise" #### โฑ๏ธ [13:30](https://www.youtube.com/watch?v=oNuj40dElaI?t=810) โ€” [H1] Accessibility as Baseline Mission - Key idea: Accessibility isn't a checklist but the foundation of the entire system - Evidence: "Accessibility is not just a checklist in Codex, it's the baseline of our mission" #### โฑ๏ธ [15:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=900) โ€” [H2] Situational Accessibility Examples - Key idea: Accessibility benefits everyone, not just users with permanent disabilities - Evidence: "Someone holding a baby with one hand and using mobile with the other reading Wikipedia" #### โฑ๏ธ [17:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=1020) โ€” [H3] Dark Mode Implementation - Key idea: Dark mode required comprehensive color palette review and desaturation - Evidence: "We needed to desaturate some colors, especially the progressive blue ones for buttons and links" #### โฑ๏ธ [19:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=1140) โ€” [H3] Diff Styles Accessibility Improvement - Key idea: Multiple visual cues replace color-only differentiation - Evidence: "We reinforce adding and removing with visual clues like icons and borders, not always relying on colors" #### โฑ๏ธ [21:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=1260) โ€” [H1] Internationalization Beyond Translation - Key idea: Supporting 300+ languages requires comprehensive cultural adaptation - Evidence: "Codex is built for more than 300 languages - this includes full right-to-left support and icon flipping" #### โฑ๏ธ [23:00](https://www.youtube.com/watch?v=oNuj40dElaI?t=1380) โ€” [H3] Localized Icon Examples - Key idea: Icons must reflect local language conventions, not just English - Evidence: "Bold in English but in Spain we say 'negrita' so we need an 'N' icon" #### โฑ๏ธ [25:30](https://www.youtube.com/watch?v=oNuj40dElaI?t=1530) โ€” [H2] Text Length Variation Challenges - Key idea: Components must work across languages with vastly different text lengths - Evidence: "Menu might work for English but what if used in Chinese or Japanese where text is much shorter?" ## ๐Ÿ“š References - [Codex Design System Documentation](https://doc.wikimedia.org/codex/) - [Wikimedia Fabricator Task Board](https://phabricator.wikimedia.org/) - [Wikipedia Foundation](https://wikimediafoundation.org/) - [Codex Telegram Channel](https://t.me/codex_design_system) ## ๐Ÿ—ฃ๏ธ Paraphrase - Codex operates as Wikipedia's federated design system where global volunteers collaborate with foundation staff through open processes, serving over 1 billion users across 300+ languages with accessibility-first principles - The system demonstrates how open collaboration creates stronger, more inclusive design outcomes despite increased complexity, with real community feedback driving improvements like mobile search enhancements and accessible diff styles - Internationalization extends far beyond translation to include right-to-left reading support, culturally appropriate icons, and flexible components that accommodate dramatic text length variations across languages ## ๐Ÿ“ฐ Newsletter **Wikipedia's Open Design System Offers Lessons for WordPress Community** The Wikimedia Foundation's approach to building Codex - their design system serving over 1 billion users - provides valuable insights for WordPress's community-driven development model. What makes Codex unique isn't just its scale, but its federated governance model. No single team owns the system. Instead, volunteers and foundation staff collaborate openly through Fabricator (their equivalent to WordPress Trac), where anyone can contribute components, provide feedback, or suggest improvements. Key takeaways for WordPress developers: - **Accessibility as baseline**: Rather than treating accessibility as a checklist, Codex embeds it as the foundation of every component - **Internationalization first**: Supporting 300+ languages means designing flexible components that work across dramatic cultural and text-length variations - **Community-driven priorities**: All new features emerge from real user needs documented in public tasks The system's approach to "good first tasks" for volunteers and open task management through Fabricator mirrors WordPress's own community contribution model, but with more structured onboarding. Resources: [Codex Design System](https://doc.wikimedia.org/codex/), [Wikimedia Fabricator](https://phabricator.wikimedia.org/), [Learn WordPress](https://learn.wordpress.org/), [Developer Docs](https://developer.wordpress.org/) ## โœ… Action Items #### DevRel - Developer advocacy: Present Codex model at WordCamp design track talks - Education: Create workshops comparing federated vs centralized design system governance - Developer experience: Document how WordPress core could adopt similar accessibility-first component development - Community management: Establish "good first tasks" boards for WordPress design contributions #### WordPress - Core: Evaluate federated design system governance models for WordPress component library - Design: Research accessibility-first component development processes from Codex - Community: Create structured onboarding for design system contributors similar to Codex model - Documentation: Document internationalization requirements for WordPress components using Codex examples - Accessibility: Implement multi-cue visual differentiation (icons + borders + color) for WordPress admin interfaces - Polyglots: Study Codex's approach to localized icons and cultural adaptation beyond translation ## ๐Ÿงช Hypotheses - Open, federated design system governance produces more accessible and internationally viable components than centralized ownership models - Community-driven component development through public task management leads to better real-world usability than internal team decisions - Accessibility-first design principles scale more effectively across diverse user contexts than retrofitted accessibility features - Multi-language design systems require cultural adaptation at the component level, not just translation at the content level ### ๐Ÿ“Š Methodology - Comparative analysis of federated vs centralized design system governance outcomes across open source projects - User testing of accessibility features across different cultural contexts and temporary disability scenarios - Component usage analysis comparing community-contributed vs internally-developed elements - Cross-cultural icon recognition studies for interface elements ### โ“ Questions - How could WordPress adopt federated design system governance while maintaining core stability and backwards compatibility? - What specific processes enable effective collaboration between volunteers and professional designers in open source design systems? - How do community-driven accessibility improvements compare to professional UX audit recommendations in terms of real-world impact? ### ๐Ÿ”ฎ Future Research - Analysis of other open source projects using federated design system models - Investigation of automated accessibility testing integration in collaborative design workflows - Study of internationalization tooling for component-level cultural adaptation ### ๐Ÿ’ก Implications - Practice: Open source projects need structured processes for design system collaboration, not just development contribution - Policy: Accessibility regulations should consider community-driven compliance processes alongside professional auditing - Education: Design system education must include cross-cultural and multi-language considerations from the start - Funding: Federated design systems require different resource allocation models than traditional centralized teams ### ๐Ÿง  Learning Styles Assessment Reading level estimate: 12th grade (complex technical vocabulary with concrete examples) #### ๐Ÿ‘€ Visual learners - Present: Component examples, before/after comparisons, dark mode demonstrations - Improve: Architecture diagrams of federated governance model, contribution workflow visuals #### ๐Ÿ”Š Aural learners - Present: 27-minute presentation with clear verbal explanations - Improve: Audio summary highlighting key collaboration processes #### ๐Ÿ—ฃ๏ธ Verbal learners - Present: Clear definitions of federated design systems, accessibility principles, internationalization - Improve: Glossary of technical terms, analogy-driven explanations of governance models #### ๐Ÿงฉ Kinesthetic learners - Present: QR codes for immediate access to Fabricator and Telegram - Improve: Hands-on workshop guides for contributing to design systems #### ๐Ÿง  Logical learners - Present: Clear progression from problem to solution, concrete examples with outcomes - Improve: Decision trees for contribution processes, metrics on community impact #### ๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘ Social learners - Present: Emphasis on community collaboration, volunteer engagement - Improve: Discussion prompts for design system governance, peer review processes #### ๐Ÿง˜โ€โ™€๏ธ Solitary learners - Present: Self-directed exploration through provided links and resources - Improve: Individual reflection questions on design system philosophy #### ๐ŸŒฟ Naturalistic learners - Present: Examples of organic community growth and ecosystem thinking - Improve: Analogies to natural systems and collaborative ecosystems ### ๐Ÿ“Š Accessibility Assessment #### Screen reader semantics - Present: Clear heading structure in presentation, descriptive component examples - Improve: Alt text for component screenshots, ARIA labels in code examples #### Keyboard navigation - Present: Discussion of keyboard navigation improvements in components - Improve: Demonstration of keyboard-only component interaction #### Contrast and readability - Present: Dark mode implementation with desaturated colors for better contrast - Improve: Specific contrast ratio examples, readability metrics #### Text resizing and reflow - Present: Discussion of responsive component behavior - Improve: Examples of component behavior at 200% zoom #### Media and captions - Present: Video presentation with clear audio - Improve: Full transcript with timestamps, downloadable captions #### Forms and interactions - Present: Search component accessibility improvements - Improve: Interactive examples of accessible form validation ### ๐ŸŒ DEIB Assessment #### Cultural breadth - Present: Extensive discussion of 300+ language support, cultural icon adaptation - Improve: More specific examples from non-Western cultures #### Inclusive language - Present: Clear, jargon-free explanations with technical terms defined - Improve: Avoid assumptions about cultural contexts #### Neurodiversity support - Present: Consistent presentation structure, clear section breaks - Improve: Content warnings for complex technical concepts #### Representation - Present: Global volunteer community emphasis, diverse use case examples - Improve: Include voices from different cultural backgrounds in examples #### Psychological safety - Present: Emphasis on welcoming community contribution - Improve: Explicit community guidelines, code of conduct references ### โœ… Logical Validity #### Strong reasoning - Deductive strength: Clear progression from open source principles to specific implementation practices - Inductive strength: Multiple concrete examples supporting broader claims about community-driven development - Causal reasoning: Direct links between community feedback and specific component improvements - Analogical strength: Effective comparison between traditional and federated design system models #### Fallacies - Appeal to numbers: "1 billion users" used as evidence of success without outcome metrics - False dichotomy: Implies open/federated is always better than closed/centralized without addressing tradeoffs #### Tone of voice - Overall tone: Enthusiastic but professional, emphasizing collaboration and inclusion with concrete technical examples ### ๐Ÿ›ก๏ธ DARVO Analysis - Deny: No denial patterns present - Attack: No attacks on alternative approaches - Reverse victim/offender: No victim/offender dynamics - Emotional cues and rhetoric: Positive framing of collaboration challenges as opportunities for improvement ## ๐ŸŽฏ Conclusion Barbara Martinez demonstrates how Wikipedia's Codex design system successfully implements federated, community-driven development at massive scale. The key insight is that open collaboration, while more complex, produces stronger and more inclusive systems when supported by structured processes like Fabricator task management and "good first tasks" for contributors. For WordPress and other open source projects, Codex offers a proven model for balancing community contribution with professional design standards, particularly in accessibility-first development and comprehensive internationalization. The practical next step involves evaluating how WordPress could adapt similar federated governance models while maintaining core stability. The broader implication suggests that design systems, like code, benefit from open source collaboration when proper infrastructure and community management support the process. ## ๐Ÿงฑ Refactor Appendix ### ๐Ÿ“š Literature Split Pad ### [H1] Federated design systems enable community-driven accessibility > [!quote] [Designing Openly for Everyone: Meet Codex](https://www.youtube.com/watch?v=oNuj40dElaI) by [[Barbara Martinez]] via [[YouTube]]. Published 2025-10-30. Accessed 2025-10-30. > "Codex is a federated design system. No single team owns it." Demonstrates alternative governance model where community and professional designers collaborate on accessibility improvements. [view highlight](https://www.youtube.com/watch?v=oNuj40dElaI#H1) #design-systems #accessibility ID:rw_federated_design ### [H2] Open collaboration produces stronger inclusive systems > [!quote] [Designing Openly for Everyone: Meet Codex](https://www.youtube.com/watch?v=oNuj40dElaI) > "Designing openly might take more effort but leads to systems that are more strong, sustainable and inclusive." Shows how community feedback improves real-world usability beyond internal team decisions. [view highlight](https://www.youtube.com/watch?v=oNuj40dElaI#H2) #community #inclusion ID:rw_open_collaboration ### [H3] Accessibility benefits extend beyond permanent disabilities > [!quote] [Designing Openly for Everyone: Meet Codex](https://www.youtube.com/watch?v=oNuj40dElaI) > "Someone holding a baby with one hand using mobile - this person will need interface easy to navigate with just one hand." Illustrates situational accessibility needs that affect all users temporarily. [view highlight](https://www.youtube.com/watch?v=oNuj40dElaI#H3) #accessibility #universal-design ID:rw_situational_access --- ### ๐Ÿ”– Atomic Split Pad (Zettel Candidates) #### [Z1] Federated governance distributes design system ownership - Scope: Open source projects with diverse contributor bases - Pointer: 05:30 timestamp on governance model - Links: [[Community-Driven-Development]] [[Design-System-Governance]] #### [Z2] Cultural adaptation requires component-level localization - Scope: International software with 100+ language support - Pointer: 23:00 timestamp on localized icons - Links: [[Internationalization]] [[Cultural-Design]] [[Icon-Systems]] #### [Z3] Accessibility improvements benefit all users situationally - Scope: Universal design principles in interface development - Pointer: 15:00 timestamp on situational disabilities - Links: [[Universal-Design]] [[Situational-Accessibility]] [[Inclusive-Design]] --- ### โœ๏ธ Fleeting Queue - [F1] Research WordPress design system governance models โ€” compare to Codex federated approach #fleeting #design-systems - [F2] Join Codex Telegram channel for community design system insights โ€” https://t.me/codex_design_system #fleeting #community - [F3] Document accessibility-first development processes โ€” extract from Codex methodology #fleeting #accessibility ## Highlights - when I first joined the Wikimedia Foundation, what amazed me most was not the scale of the project that is over a billion of users. What most amazed me was how open everything was. Because anyone could see our work, contribute, and improve it. And when I started working in Codex, I realized that Codex is not only the design system, it's a living conversation with people from everywhere and in all the world. Designing for Wikimedia ([View Highlight](https://read.readwise.io/read/01k8tf3rmgs0z8wwgqw3anx8xp)) - Tags: ๐Ÿ‘ป ai highlighted - to unify all these previous things, but always without losing the origins, because it's important that we communicate always the essence of Wikimedia and Wikipedia. And what makes Codex truly unique is that it's built through open collaborations. Contributors from Wikimedia Foundations, Wikimedia Deutzland, and also the ([View Highlight](https://read.readwise.io/read/01k8tf3rmq382z6ab6cqekv95n)) - Tags: ๐Ÿ‘ป ai highlighted - can ask questions. You can open any conversation related with the Codex design system. And another thing that makes the Codex design system unique is the accessibility, of course. Accessibility is not just a checklist in Codex. It's the baseline of our mission. Accessibility is about making sure that everyone can navigate, interact, and ([View Highlight](https://read.readwise.io/read/01k8tf3rnc6qhc23dq8f7vq96x)) - Tags: ๐Ÿ‘ป ai highlighted - in Spain we say cursiva. So we need to always make sure that anything, any component or any icon that we include in Codex is not only included, we need to make sure that this is going to work for the different 300 languages and the different hundreds of cultures that we work for. So yeah, in Codex we added up the icons, and we include locally saved versions for icons and components. And also we ([View Highlight](https://read.readwise.io/read/01k8tf3rqb5ktkacm0xnnnqkgf)) - Tags: ๐Ÿ‘ป ai highlighted