Documentation

April 2026

• Apr 14, 2026CultureAsync Communication Strategies for Distributed TeamsWhat async-first actually requires beyond replacing meetings with chat. GitLab operates with roughly 2000 team members in more than 65 countries and no central office, publishing its handbook openly so the practices can be examined. The principles are a single source of truth, default to public, and written communication over verbal. The article is direct that documentation cost is the real tradeoff.16 MIN3.8k

October 2025

• Oct 21, 2025Work SkillsOverview of Documentation Tools: Accessing KnowledgeIBM introduced the 704 in 1954 with 700 pages of documentation engineers had to absorb, and the underlying problem has not changed in seven decades: how to capture what experts know without the expert standing over your shoulder. Stripe hired technical writers in 2015 and by 2020 Stripe-quality docs was industry shorthand, a deliberate competitive advantage. Documentation splits into four kinds, reference, conceptual, procedural and institutional knowledge.22 MIN2.0k
• Oct 16, 2025Work SkillsExploring Documentation Debt: Causes and ConsequencesAghajani and colleagues examined 878 open-source repositories for ICSE 2019 and found documentation issues reported in three quarters of actively maintained projects, with outdated information the most frequent complaint. Their sharper finding was about timing: debt accumulated fastest during maintenance, not initial development, when feature velocity was high and doc updates got deprioritized. The page covers docs-as-code, the five debt types, and when to declare bankruptcy.21 MIN31.9k
• Oct 16, 2025Work SkillsOverview of Technical Documentation Types and UsesStripe launched in 2011 with API documentation developers called the best they had used, and grew faster than rivals in a crowded payments market because founders could integrate in an afternoon instead of spending weeks. Daniele Procida's Diátaxis framework splits documentation by what the reader needs: tutorials for learning, how-to guides for tasks, reference for lookup, explanation for understanding. Why mixing the four creates confusion.21 MIN62.8k
• Oct 15, 2025Work SkillsDocumentation Systems ExplainedA 2012 McKinsey Global Institute estimate put the share of the workweek knowledge workers spend searching for and gathering information at 19 percent. GitLab's answer was a public handbook that grew past 2,000 pages while the company scaled from 100 to more than 1,500 employees. This guide covers the four pillars of storage, structure, process and discovery, organizing by user task rather than org chart, the Divio four-type model, and why documentation decays.21 MIN45.3k
• Oct 14, 2025Work SkillsKnowledge Writing: Capturing and Sharing ExpertiseNonaka and Takeuchi named the organizational version of the failure in 1995, calling it externalization without internalization, where firms build wikis and procedures that nobody absorbs because reading a document is not the same as forming the mental model behind it. Klein's cognitive task analysis works around this by observing experts deciding and asking them to explain each call as they make it, which captures far more than asking them to write up what they know.18 MIN18.2k

July 2025

• Jul 29, 2025IdeasBest Practices for Effective Documentation SystemsDocumentation fails from lack of system, not lack of writing: fragmented wikis, no designated owner, and structures built for writers rather than readers. Stale docs erode trust more than no docs at all, and knowledge reverts to oral tradition that leaves when people do. The four documentation types serving distinct purposes, why each decays, and the ownership, maintenance cycles and workflow integration that keep documentation trustworthy enough to actually use.22 MIN8.5k

November 2022

• Nov 11, 2022Work SkillsTechnical Writing: Skills and Effective PracticesHis Divio framework separates them by purpose. A tutorial is a cooking lesson that gets a beginner to something edible, a how-to guide is a recipe for someone who already cooks, reference exists to be looked up rather than read, and explanation covers rationale and tradeoffs. Mixed together, the reader cannot find anything, and stale reference material is worse than none at all.15 MIN2.3k

August 2022

• Aug 3, 2022Work SkillsUnderstanding Knowledge Management in OrganizationsThe Society for Human Resource Management found that gap in 2019, and Deloitte put 42% of institutional knowledge in employees' heads rather than in any documented form. Nonaka's SECI model explains why documentation cannot close it, since the tacit-to-tacit transfer that happens by working alongside someone does not survive being written down. Leonard-Barton named the opposite failure, core rigidities, where a process works but nobody understands it well enough to change it.23 MIN7.1k