Docs style update

[hellt]

Summary

Switching from the 5 years old docs engine to Zensical. New home page layout, new build system.

to try it out:

make serve-docs

The documentation site now has a redesigned, responsive home page with clearer product messaging, guided quick-start examples, telemetry workflow visuals, and direct paths to key guides and deployment examples. The header and branding were refreshed with theme-aware logos, a custom light/dark-mode switch, and a dedicated favicon.

Documentation discovery was improved by adding a consistent tag taxonomy across commands, guides, integrations, processors, and deployment examples. Search now supports tag-based filtering and highlighted results.

Documentation development and publishing now use a locked Zensical/uv environment with make targets for serving, building, updating, and deploying the site. CI uses the same workflow, providing a consistent strict build locally and in GitHub Actions.

Finally, tool and container versions are centralized in versions.env and consumed by local wrappers, CI, Docker builds, release tooling, and integration tests. This reduces version drift and gives maintainers a single place to manage supported tool versions.

History

• e1a86174 — Initializes the documentation refresh: adopts a locked Zensical/uv toolchain, adds reproducible local build/serve/deploy commands and CI publishing, modernizes the base theme/navigation, and fixes several documentation links. This gives contributors and CI one consistent, strict documentation build path.

• ffa33d68 — Adds dedicated light- and dark-background gNMIc wordmark assets plus header overrides that select the appropriate logo. This keeps the brand legible and visually consistent in either color scheme.

• 443d3b9d — Replaces the basic home page with a responsive product landing page: hero, capability and telemetry sections, quick-start examples, clearer calls to action, dedicated styling, and fragment-aware tab behavior. This makes the documentation entry point more useful for both new users and returning users.

• eb9eee9c — Adds a shared taxonomy of page tags across commands, integrations, deployments, processors, and guides, and configures tag icons and highlighted search results. This improves search filtering, related-content discovery, and documentation organization.

• dd7ebb9a — Centralizes development, CI, release, Docker, and test-image versions in versions.env; adds wrappers and validation to consume those versions consistently. This reduces version drift and makes builds, tests, releases, and documentation tooling reproducible.

• adae6d35 — Adds a gNMIc-specific SVG favicon and configures the documentation site to use it. This improves branding in browser tabs while preserving contrast in dark color schemes.

• 43ce26e0 — Replaces the default palette control with an accessible, animated header theme switch that preserves the documentation theme’s native keyboard controls and stored preference behavior. This provides a clearer light/dark-mode experience while respecting reduced-motion settings.

• 72f40c14 — Refines the home-page hero glow’s position, size, and mobile behavior so it frames the logo rather than bleeding into navigation. This improves visual focus and polish across screen sizes.