Writing, Technically with James Somers
Signals and Threads
00:00
Getting More Out of Your Documentation
The search is about discoverability. Some of the features you talked about in the publishing system are about essentially social feedback, almost the gamification of documentation making. And then the last point, it sounds mechanical and boring just that, oh, the docs are going to break when your code changes. But actually, it's just an excuse to go back and look at the docs and to change them. I think people are actually pretty good about thinking about their documentation when it's in-site. It's just that it is so often out of sight out of mind.
Transcript
Play full episode
