Skip to content

documentation

6 posts

The Anatomy of a Good Technical RFC: Section-by-Section Breakdown

A guide to crafting technical RFCs that actually get approved and drive successful implementations, based on reviewing hundreds of documents

rfctechnical-writingarchitecture+5
Writing Effective RFCs: A Guide to Technical Decision Making

Hard-won insights from RFC processes, stakeholder management, and turning technical debates into collaborative decisions that stick.

rfctechnical-writingarchitecture+5
When Your Star Developer Quits: Managing the Bus Factor in Engineering Teams

How to protect your team from single points of failure through knowledge distribution, documentation strategies, and systematic risk management based on real-world engineering experiences.

team-managementdocumentationknowledge-sharing+5
Documentation as Infrastructure: Scaling Knowledge Across Engineering Teams

Documentation debt kills organizations faster than technical debt. A comprehensive guide to treating documentation as critical infrastructure and scaling knowledge across engineering teams.

documentationrfcadr+4
Complete Mermaid Diagram Showcase: All Chart Types

Comprehensive showcase of all Mermaid diagram types with interactive examples for flowcharts, sequence diagrams, Gantt charts, and more

mermaiddiagramsdocumentation+4
Complete Markdown Typography Guide

A comprehensive guide to all markdown typography features and formatting options.

documentationmarkdowntutorial+1