PostHog’s old docs were exhaustive and impossible to navigate: a left-sidebar tree with five levels of nesting and no shape. The new docs reorganize around three axes: by product (analytics, replays, feature flags), by integration (web, iOS, Android, server SDKs), and by intent (just-shipped tutorials, deep references, troubleshooting). The default view is search-first: a big input above the fold, with most-clicked recent results listed below as breadcrumbed cards. The sidebar is still there but it’s secondary now.
The dark-mode work is the part worth opening the inspector on. Most “dark mode” on docs is a CSS-variable flip that ends up looking like inverted Stack Overflow: black borders on near-black surfaces, code blocks that hum at the same value as body copy. PostHog’s dark mode has its own tonal hierarchy. Surfaces are graded across four grays, code blocks sit on a slightly cooler surface than prose, headings are a single near-white instead of pure white. It looks like someone designed it twice rather than once with a toggle. The thing they got wrong: the search input could be cmd-K-able from any page. Currently you have to click into it. Pattern to steal: if you’re shipping dark mode, design it as a separate pass, not a token flip. The work is in the surface graduations, not the foreground colors.