Field notes

2026 · Field notesAbout 1 min read

Multi-product companies need clear URLs and stable documentation

Information architecture for teams that ship more than one product—without turning every page into a maze.

Abstract gradient suggesting documentation and structure

When you operate more than one product, users confuse hostnames, paths, and support channels. The fix is not more landing pages; it is a predictable map. A hub should answer: what exists, what is live, what is alpha, and where to click for help. Spokes should answer deep questions: how to implement, how to authenticate, and where to get status.

Prefer stable hub URLs in marketing copy. Deep links to transient marketing slugs break when campaigns change. If you must deep-link, add redirects when you rename paths. Your future self will thank you when a partner asks for a link that still works.

Internal habits

Maintain a single internal index of canonical URLs. When someone shares a deprecated URL in a chat, correct it once and update the index. If the correction happens only verbally, the bad link will recur.

Abstract gradient suggesting maps and indexes
One canonical map beats a dozen improvised explanations.

Search and discovery

Search engines reward clear titles and consistent structure. Duplicate content across subdomains dilutes rankings. If two pages say the same thing, pick a canonical URL and link from the other. If you localize, use hreflang and consistent slugs where possible.

Onboarding and support

New hires and partners should not need oral history to find truth. Onboarding docs should include: where the hub lives, where each product’s docs live, how to file issues, and how to reach humans for urgent incidents. Update the doc when URLs change.

Support macros should link to canonical articles. If a macro contains a stale URL, every reply spreads confusion. Review quarterly or when a product rebrands.

Accessibility matters for documentation. Headings, alt text, and readable contrast help everyone, not only screen-reader users. PDFs are often harder to maintain than HTML; prefer web pages for living content.

When you deprecate a product or path, publish a deprecation timeline and a migration guide. Silence forces users to guess.

Privacy & Compliance

We use optional analytics cookies (Google Analytics) to understand aggregate traffic. By clicking "Accept", you agree to those cookies. See Cookies & analytics for details and how to change your choice later.