We've rolled out a round of upgrades to this documentation site — a refreshed theme foundation, instant search, and a much better reading experience for code samples. Here's what changed.
A refreshed foundation
The site now runs on an updated version of its underlying theme. Beyond the visual polish — a cleaner icon set, refined navigation, and small consistency fixes across page types like Roadmap and Showcase — this update also brings the site onto a more current, better-maintained base for future improvements.
Instant search
Press ⌘K (or Ctrl+K on Windows/Linux) anywhere on the site to search — no page reload, no waiting.
A few things that make it fast and precise:
- Search runs per section, not per page — results jump straight to the relevant heading, not just the top of a long article.
- The full index lives in your browser and refreshes automatically whenever content changes, so results are always current without a noticeable delay.
- Fuzzy matching means small typos still find the right page.
Better code blocks
This is the big one for anyone reading technical content here. Code samples now come with:
Line numbers, on by default, so you can reference "see line 12" without ambiguity.
Line highlighting, so authors can draw attention to specific lines. For example:
const map = window.map;
const layer = map.layerTree.findLayerById("poi");
layer && map.layerTree.removeChild(layer);
Diff blocks, for showing before/after changes clearly:
- const location = ShapeFactory.createPoint(ref, [coords[0], coords[1]]);
+ const location = ShapeFactory.createPoint(ref, [coords[1], coords[0]]);
Bracket matching — click any bracket, parenthesis, or tag to see its matching pair highlighted, which helps a lot when reading deeply nested XML or JSON.
One-click copy, via the button that appears in the top-right corner of every code block on hover.
Colors that adapt to your theme. Code blocks now use a warm, readable Solarized Light palette in light mode and a high-contrast Tomorrow Night palette in dark mode, so syntax highlighting looks intentional either way — instead of a single dark theme forced onto a light page.