This style guide captures patterns from 20+ years of technical writing about software, design, and the human side of technology. It’s designed to help maintain voice consistency when collaborating with editors and AI writing tools.
Voice & Tone Conversational yet thoughtful: You write as if speaking to a knowledgeable friend, mixing technical insights with personal reflections Self-aware and introspective: Often examining your own processes, biases, and growth as a developer/creator Authentic and unpretentious: Willing to admit mistakes, share frustrations, and discuss failures alongside successes Occasionally profane: Strategic use of mild profanity for emphasis (“just fucking do it”), but it does not need to be found in every essay. Structure & Format Clear, descriptive headlines and titles: Favor sentence case, often starting with action verbs or questions Short, punchy paragraphs: Usually 2-4 sentences, making content scannable Thoughtful use of formatting: Bold text for emphasis, italics for key terms, blockquotes for external sources, and codeblocks for code and terminal examples Lists and examples: Break down complex ideas into digestible points Visual elements: Include diagrams, screenshots, and code snippets where relevant Content Characteristics Practical philosophy: Blend technical topics with broader life lessons and creative process insights Historical perspective: Often reference the evolution of technology and your own journey through it Metaphors and analogies: Use everyday comparisons to explain technical concepts (e.g., comparing design skills to learning to ride a bike) Personal anecdotes: Share specific experiences from your career to illustrate points Meta-commentary: Frequently write about the process of writing, creating, and thinking itself Recurring Themes Technical Craft & Architecture Technical debt vs. technical regret: Making informed technical decisions vs. poor planning System design fundamentals: Architecture, diagramming, and thinking before coding Minimalism in tools and process: Simple, focused tools over complex systems Pragmatism over ideology: Choosing approaches based on effectiveness The craft of software as art: Intersection of technical skills, creativity, and aesthetic sensibility The business reality of software: Balancing technical excellence with commercial viability Tool-specific workflows and context management: When to use different AI tools and optimizing for each tool’s strengths Human Elements & Sustainability The human cost of technology: Burnout, imposter syndrome, work-life balance, and maintaining passion Finding your authentic voice: The struggle between internal thoughts and external persona Cognitive load and burnout in the age of acceleration: How faster tools create new mental fatigue Environmental psychology of creative work: Physical/digital spaces and creative output The psychology of engagement and motivation: Feedback loops, gamification, and sustained creative work Productivity through focus: Managing attention, avoiding distractions, creating environments for deep work Learning & Creative Process Action over analysis paralysis: “Just doing it” vs overthinking, getting unstuck Learning through iterative practice: Building skills through repetition, failure, and reflection Writing as thinking: Using writing to clarify thoughts, document learning, and find voice Teaching through doing: Code review, mentorship, and learning by building together Side projects as learning vehicles: Personal projects for exploring ideas and maintaining creative energy Media diet and intentional consumption: Curating inputs to feed creativity and learning Industry Evolution & Future Evolution of computing culture: How tools, practices, and thinking have changed from the 80s/90s to present Historical context as perspective: Using past experiences to understand present challenges AI as collaborative partner, not replacement tool: Treating AI as thought partner and amplifier of human expertise The commoditization cycle of technology: How transformative tech becomes invisible infrastructure Cross-cutting metaphors:
...