- Etsy’s experiment with immutable documentation
Paul-Jean describes Etsy's approach towards maintaining up-to-date documentation: separating how-docs from why-docs, and optimizing for freshness rather than completeness with how-docs using a Slack tool.
- Five ways to make your internal docs shine
Greg offers some guidelines in writing documentation: 1. Ask your teammates what to document; 2. Make your docs timely, but not timeless; 3. Link to each doc from at least three places; 4. User test your docs; 5. Treat your docs as prepend-only.