---
title: "Recording of my WTD Portland 2017 presentation on Building navigation for your doc site – 5 best practices"
date: 2017-06-08
description: "Audio only Slides Presentation description More resources Audio only If you just..."
canonical_url: https://idratherbewriting.com/2017/06/08/write-the-docs-presentation-navigation-best-practices/index.html
---

> For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL.

# Recording of my WTD Portland 2017 presentation on Building navigation for your doc site – 5 best practices

> Here's the recording of the presentation I gave at the Write the Docs 2017 Portland conference. The presentation explores best practices for doc navigation, including principles such as hierarchy, modularity, progressive disclosure, entry point, and wayfinding. The presentation is about 20 minutes long, and you can either watch a video or listen to audio. Other WTD presentation recordings are also available.

[Video: Video](https://www.youtube.com/embed/w-kEmsLwPDE)

## Audio only

If you just want the audio, here it is:

**Listen to this presentation:**

[Audio](https://www.podtrac.com/pts/redirect.mp3/s3.us-west-1.wasabisys.com/idbwmedia.com/podcasts/wtdportland2017navigationbestpractices.mp3)

You can also [download the MP3 file](https://www.podtrac.com/pts/redirect.mp3/s3.us-west-1.wasabisys.com/idbwmedia.com/podcasts/wtdportland2017navigationbestpractices.mp3), [subscribe in iTunes](https://itunes.apple.com/us/podcast/id-rather-be-writing-podcast/id277365275), or [listen with Stitcher](http://www.stitcher.com/podcast/id-rather-be-writing-technical-writing-podcast).

## Slides

Here are the slides:

[![](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/wtdpresoportland.png)](https://idratherbewriting.com/files/doc-navigation-wtd/index.html)

## Presentation description

**Write the Docs 2017: Building navigation for your doc site: 5 best practices by Tom Johnson**

Although users typically arrive at doc websites in a confused and impatient state, not sure of where to find what they’re looking for, good navigation can guide them to the right answer. Good navigation anticipates users’ needs, provides links in commonly viewed places, and brings the right topic into the foreground amid hundreds of other topics.

As you build out the navigation for your doc site, follow these 5 design principles:

- **Entry point**. Design the entry point to your system to orient users and allow them to easily get started.
- **Hierarchy**. Create a hierarchical outline of the content to help users both understand and visualize the body of information.
- **Modularity**. Break up content into independent topics that can be viewed, understood, and updated independent of the whole.
- **Progressive disclosure**. Layer the information so that you don’t present everything at once but rather make some content available only at secondary or tertiary levels.
- **Wayfinding**. Provide navigational signposts — such as breadcrumbs and workflow maps — to help orient users as to where they are in a larger system.

## More resources

To watch other Write the Docs 2017 Portland conferences videos, see the [this playlist on the Write the Docs YouTube channel](https://www.youtube.com/playlist?list=PLZAeFn6dfHpkBld-70TsOoYToM3CaTxRC).

To learn more about the Portland Write the Docs conference, see [writethedocs.org/conf/na/2017/](http://www.writethedocs.org/conf/na/2017/).

If you missed my conference write-up, see [Impressions from the Write the Docs Conference – and thoughts on achieving sustainability without selling out to vendors](https://idratherbewriting.com/2017/05/23/write-the-docs-and-the-battle-against-vendor-evil/).