Docs discoverability layers

When someone says a doc site is "discoverable", they often mean that a human can find it through a search engine or use the in-site text-based search. Most documentation sites are built for human readers. If a page loads correctly and reads well, it is considered discoverable. This assumption covers only one dimension. Search engines need signals to crawl and index pages. They need to know which…