Refresh docs landing page

[Marzogh]

What changed

This refresh rebuilds the docs landing page so it works as a simpler operator-first homepage.

It now:

• opens with a plain-English intro and clearer start actions
• groups the homepage into Get Running, Use OrbitDeck, Understand the System, and Reference and Troubleshooting
• adds a light MkDocs homepage stylesheet for restrained card and button structure
• keeps the existing docs navigation intact
• updates site_url to the published docs host at https://chipsncode.com/OrbitDeck/
• removes a lot of docs-strategy wording in favor of simpler plain-English copy

Why

The old docs homepage was accurate, but it felt like a short index page and used too much meta language. This pass makes the landing page easier to scan, easier to trust, and easier to use without turning it into a flashy marketing page.

Scope

Included:

• docs/index.md
• docs/stylesheets/docs-home.css
• mkdocs.yml

Not included:

• nav reshuffles
• product or API behavior changes
• changes to the deeper docs pages beyond the homepage links

Validation

• ran mkdocs build --strict successfully after the landing-page updates
• checked the generated homepage HTML for the new layout blocks and expected links

[Copilot]

Pull request overview

Refreshes the OrbitDeck documentation landing page to be a clearer, operator-first homepage while keeping the existing MkDocs navigation structure intact.

Changes:

• Rewrites docs/index.md into a structured homepage (intro/actions + sectioned link cards).
• Adds a lightweight homepage stylesheet and wires it into MkDocs via extra_css.
• Updates site_url to the published docs host.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
mkdocs.yml	Updates canonical site_url and includes the new homepage stylesheet via extra_css.
docs/index.md	Rebuilds the homepage content into operator-focused sections with card/button layout.
docs/stylesheets/docs-home.css	Adds restrained styling for homepage intro, action buttons, and card grids.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

This page links to other docs using directory-style URLs (e.g. guide/quickstart/, api/http-api/, INSTALL_AND_RUN/). Elsewhere in the docs and in mkdocs.yml nav, links point to the source .md files. Using the trailing-slash form can break when viewing docs on GitHub or if use_directory_urls is ever changed; consider switching these href values to the corresponding .md paths for consistency and portability (MkDocs will still rewrite them to pretty URLs in the built site).

[Copilot]

color-mix() is used for several border/background colors here. On browsers that don’t support color-mix (not uncommon on older Chromium builds), those declarations are dropped entirely, which can leave the cards/buttons without visible borders/backgrounds. Consider adding a plain-color fallback first (or wrapping the color-mix rules in @supports) so the homepage styling degrades gracefully.