What They Don't Tell You About Creating New Style Guides

on YouTube ↗23m

" summary

Notes give specific artifacts: a Responsible Communication style guide that began as personal mistake lists and a style supplement for Python; workflow advice says to move out of a word processing tool after five pages. Three concrete problems get solved — question assumptions, bring in unheard voices, provide tooling and education — with steps: beta testers, sensitivity readers, outreach to code schools, and iterative editions. The point is whether a guide is usable, adopted, and updated, not whether the topic sounds important.

AI-written summary · about

" chapters (7)

1. 0:00Style guide creation intro
2. 4:43Why style guides matter
3. 8:59Key challenges in guides
4. 15:23Ethical design in guides
5. 16:08Inclusivity in style guides
6. 20:38Diverse feedback for guides
7. 22:27Conclusion & Q&A

" related talks

• 16mStyling for Inclusion: How Shaping a Style Guide ...Thursday Bram · AlterConf Portland 2017
• 42mDesigning Inspired Style GuidesAndy Clarke · Talk.CSS max-content Edition
• 32mBuilding a style guide from the ground up: lessons learned from a lone writerDeanna Thompson · Write the Docs Portland 2021
• 49mHow to Create and Maintain a Visual StyleguideFabio Fabbrucci · Codemotion Rome 2015
• 37mThe ABC of Coded Style GuidesHenning Muszynski · React Alicante 2018
• 29mStyleguides are dead! Long live Styleguide-Flows!Joao Da Silva Marly · EmberFest 2021
• 30mThe ABC of Coded Style GuidesHenning Muszynski · OdessaJS 2018
• 34mThe Dream of Styleguide Driven DevelopmentSara Vieira · JSHeroes 2018