Company
Date Published
Author
Hahnbee Lee
Word count
1329
Language
English
Hacker News points
7

Summary

Stripe creates the best documentation in the industry by fostering a strong writing culture that encourages employees to write high-quality documentation. The company has embedded writing into its culture, with a press that publishes books and an engineering magazine, and leaders who set the tone for thoughtfulness and attention to detail. Stripe also created support systems, such as resources and guides for developers on how to write good docs, classes on writing and documentation best practices, and office hours where employees can seek advice from technical writers and documentation experts. The company includes documentation expectations in engineers' job ladders and rewards people for creating high-quality documentation. Finally, Stripe builds documentation that feels like a product, with interactive features and a custom syntax called Markdoc.