4min chapter

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

Get the Snipd
podcast app

Unlock the knowledge in podcasts with the podcast player of the future.
App store bannerPlay store banner

AI-powered
podcast player

Listen to all your favourite podcasts with AI-powered features

Discover
highlights

Listen to the best highlights from the podcasts you love and dive into the full episode

Save any
moment

Hear something you like? Tap your headphones to save it with AI-generated key takeaways

Share
& Export

Send highlights to Twitter, WhatsApp or export them to Notion, Readwise & more

AI-powered
podcast player

Listen to all your favourite podcasts with AI-powered features

Discover
highlights

Listen to the best highlights from the podcasts you love and dive into the full episode