
Writing, Technically with James Somers
Signals and Threads
Documentation - The Classic Curse of Knowledge
There is a legitimate trade-off where if you write documentation that's very full of examples and very details-driven, it can be a real slog to get through. Good documentation contemplates the universe of readers up front and presents a menu that says kind of choose your own adventure. Consition is really good but at the same time, meeting the readers where they are is also really good.
00:00
Transcript
Play full episode
Remember Everything You Learn from Podcasts
Save insights instantly, chat with episodes, and build lasting knowledge - all powered by AI.