Search results

New section on my site: Simplifying complexity

by Tom Johnson on Jan 24, 2018
categories: simplifying-complexity

In an earlier post on value arguments for tech comm, I mentioned that in 2018, I plan to explore some innovative ways to simplify complexity so that I can deepen the value I provide to users. To host this content, I created a new section on my site called "Simplifying Complexity." So far I've added just one topic there on navigation maps. In the topic, I argue that by allowing users to toggle between micro and macro views of a system, often through embedded workflow maps, you can help users better understand and orient themselves in complex systems.

You can read the post here: Switching between macro and micro views with embedded maps.

The micro-macro principle is as follows:

To help users navigate a complex system, provide a way for users to switch between macro and micro views of the system. One of the easiest techniques to enable this view switching is to embed a map (at the top of each relevant topic) that shows the path to achieving a goal.

You can get to this section by clicking the Complexity button on my main navigation bar.

For the earlier post on deepening value by focusing on complexity, see Part VI: Deepening documentation’s value by simplifying complexity.

Sponsored

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, agent skills, tech comm careers, and more. Check out my AI courses for more on the latest in AI and tech comm. If you're looking for info about documenting APIs, see my API documentation course.

If you're a technical writer and want to keep on top of the latest trends in tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me.

Finally, I want to note a couple of things. I usually write the first drafts of my posts myself and then use AI to improve accuracy, clarity, and detail in places, so my writing is a mix of human and AI. (Hopefully that's not too off-putting.) Also, the opinions I express on my blog are my own perspectives, not those of my employer.

© 2026 Tom Johnson