Signals and Threads cover image

Writing, Technically with James Somers

Signals and Threads

CHAPTER

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.
App store bannerPlay store banner