Skip to content

Home: show both ways of investigating with AI - #903

Merged
wu-sheng merged 1 commit into
masterfrom
feat/home-ai-two-ways
Aug 21, 2026
Merged

Home: show both ways of investigating with AI#903
wu-sheng merged 1 commit into
masterfrom
feat/home-ai-two-ways

Conversation

@wu-sheng

Copy link
Copy Markdown
Member

The home page led with observability for AI and treated AI for observability as a single product feature. SkyWalking now runs in both directions, so the hero and the highlight rows say so.

Hero

H1 Observability for cloud-native and AI. / And AI for observability. — two sentences, keeping the identity term the project is known by
Lead now names both paths, not just the built-in assistant
Meta description followed suit — it is what search results and social cards actually render, and it still described only the assistant

seo_title is deliberately unchanged. Adding the second clause makes it 83 characters; Google renders about 60, so it would truncate mid-phrase and gain nothing. It stays at 57 and fully visible.

Highlights

A second row for the AI-client path, with the Codex desktop capture and the capability / permission / credential boundary as its three points. The 3D-map row flips so the rows keep alternating.

The clip is referenced from /screenshots/horizon-1.0/ rather than copied into /images/home/, so the 3 MB file is stored once and shared with the Codex post that also uses it.

Deep-link hooks

The three feature headings get copy-able hooks — #ai-assistant, #ai-client, #topology-3d — reusing the select-and-copy behaviour the docs and downloads cards already ship, rather than new JS. The home page renders through the theme's baseof, which we do not fork, so the script arrives as a shortcode.

Two things worth knowing for anyone touching this later:

  • The hook lives in a .frow-title wrapper that owns the containing block. Positioning it against the h2 broke whenever an ancestor gained position.
  • The id sits on that wrapper, not the h2. Docsy's anchor.js appends its own hook to any heading carrying an id, which produced a second, duplicate icon.

Wording

No component names in the hero or the new row. Horizon is a project and component; SkyWalking is the brand a reader knows. OAP, a permission identifier and "registry" were also removed — each assumed a concept the page has not introduced by that point, and OAP appeared nowhere else on the page.

Horizon still appears in row 1 and the capabilities card, which are existing copy and out of scope here.

Media

Refreshes the AI Assistant clip and poster — now 1920x936 and matching each other.

Verification

Clean hugo build, no errors: 3 feature rows, all three hooks present, zero h2 elements carrying an id (so no theme duplicate), zero Horizon inside the hero <section>, and both clips published at full size.

Links

Both rows point at /next/ docs, matching how the assistant row already linked. MCP is merged to horizon-ui main and its page is live, but it is not in a tagged release yet, so /latest/ has no mcp page. The Codex announcement post is still draft: true — an HTML comment marks where it becomes a second CTA once it publishes.

The page led with observability *for* AI and treated AI *for* observability
as one product feature. SkyWalking now runs in both directions, so the hero
and the highlight rows say so.

Hero: the headline becomes two sentences, keeping the cloud-native identity
and adding the turn. The lead names both paths instead of only the built-in
assistant, and the meta description follows — it is what search and social
actually render, and it still described only the assistant.

Highlights: a second row for the AI-client path, with the Codex desktop
capture and the capability/permission/credential boundary as its points. The
3D-map row flips to keep the rows alternating. Its clip is referenced from
/screenshots/horizon-1.0/ rather than copied into /images/home/, so the 3 MB
file is stored once and shared with the Codex post that also uses it.

Deep-link hooks on the three feature headings, reusing the copy-and-select
behaviour the docs and downloads cards already ship. The home page renders
through the theme's baseof, which we do not fork, so the script comes in as a
shortcode. The hook lives in a .frow-title wrapper that owns the containing
block, and the id sits on that wrapper rather than the h2 — the theme's
anchor.js injects a second hook into any heading carrying an id.

No component names in the hero or the new row: SkyWalking is the brand a
reader knows, and OAP, a permission identifier and "registry" all assumed
concepts the page has not introduced yet.

Also refreshes the AI Assistant clip and its poster, now 1920x936 and
matching each other.

Links go to the /next/ MCP doc, matching how the assistant row already links.
MCP is on horizon-ui main and its page is live, but not in a tagged release
yet, so /latest/ has no mcp page. The announcement post is still a draft; it
becomes a second CTA when it publishes.
@netlify

netlify Bot commented Aug 21, 2026

Copy link
Copy Markdown

Deploy Preview for skywalking-website-preview ready!

Name Link
🔨 Latest commit 9b68202
🔍 Latest deploy log https://app.netlify.com/projects/skywalking-website-preview/deploys/6a87b656331ceb0008c8f487
😎 Deploy Preview https://deploy-preview-903--skywalking-website-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@wu-sheng
wu-sheng merged commit fb0cc4f into master Aug 21, 2026
4 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant