Session Spotlight

Steven Hicks

Camp Counselor

Misadventures in SEO: How to self-sabotage your documentation

Event Logo

Tuesday, July 30, 2024 - 9:00 PM UTC, for 1 hour.

Regular, 60 minute presentation

Room: African 30

SEO
documentation

Documentation is a critical feature in the developer experience of any product. When your docs are sparse, confusing, or nonexistent, developers can't use your product. What if your docs are great, but no one can find them? I assure you, from personal experience — you'll end up with frustration all around. From the docs team who can't figure out what's happening, to the users who can't find anything, to the support team that must memorize the entire documentation structure in order to help users. In this session we'll look at my team's misadventures in the SEO of our product documentation. Our best intentions were outdone by our misunderstanding of SEO concepts, and we accidentally eliminated the ability to search our documentation. It's been a difficult hole to crawl out of — and we're still not fully out of it! I'll share the steps we've taken that have helped, the steps that haven't helped, and how we're applying this learning to our other documentation sites. You'll leave with a better understanding of SEO, and how it applies to your product's documentation.

Take Aways

  • Learn how search engines crawl and index content
  • Learn how search engines deal with duplicate content
  • Understand the effects of mismanaging search engine hints within your content
  • Learn how to re-index content that has been removed from Google's search index
favorited by:
Kevin Powell Josh Gretz Craigory Coppola Joel Keyser Justin Allard Justin Weyenberg