Docs: add AI Sessionizer, and fold Grafana Plugins into SkyWalking Servers - #915
Merged
Merged
Conversation
…rvers
apache/skywalking-ai-sessionizer already carries docs/ with a menu.yml, so
its documentation is hosted on the site rather than linked out to GitHub.
A Next entry only: the repo has no tags and no releases, and pinning a
versioned entry to a main commit would publish docs for a version that
does not exist.
Grafana Plugins is no longer a top-level section. Its one project moves
into SkyWalking Servers, next to the sessionizer. Two consequences of
dropping the section header:
- The card is renamed "Plugin for Service Topology" -> "Grafana Plugin
for Service Topology", since without the header the old name no longer
said what it plugs into. This changes its anchor from
#PluginforServiceTopology to #GrafanaPluginforServiceTopology.
- The section's standalone note card ("Metrics visualization on Grafana
is supported through PromQL...") had no section left to preface and
would have rendered as a stray text tile among project cards, so its
substance moves into the entry's own description, trimmed to fit the
card's three-line clamp.
The merged section mixes a GitHub-linked entry with website-hosted ones.
That is safe and already precedented in five other sections: docs.js
guards on repoUrl per item, not per section.
Verified with npm run docs — the generation CI runs — plus a full hugo
build. All seven sessionizer pages render, its card resolves Read docs to
the hosted page with no versions dropdown, the Grafana card keeps its
GitHub links and v0.1.0 dropdown, and the page is down to ten sections
with no orphan note card.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
❌ Deploy Preview for skywalking-website-preview failed.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
AI Sessionizer
apache/skywalking-ai-sessionizeralready carriesdocs/with amenu.yml, so its documentation is hosted on the site rather than linked out to GitHub. Seven pages render: Welcome, four under Concepts and Designs, two under Adapters.A
Nextentry only — noLatest, no version. The repo has no tags and no releases, and pinning a versioned entry to amaincommit would publish docs for a version that does not exist. Nothing was added toreleases.yml; there is nothing to download yet.This is the site's first
Next-only component, so the card's primary-link path ("theLatestentry if present, else the first one") was verified rather than assumed: Read docs resolves to/docs/skywalking-ai-sessionizer/next/readme/, and no versions dropdown renders.Grafana Plugins folded in
Grafana Pluginsis no longer a top-level section — the page goes from 11 sections to 10. Its single project moves into SkyWalking Servers, beside the sessionizer:Two consequences of dropping the section header, both worth a look:
Plugin for Service Topology→Grafana Plugin for Service Topology. Without the header, the old name no longer said what it plugs into. This changes its anchor from#PluginforServiceTopologyto#GrafanaPluginforServiceTopology, so any existing deep link to it breaks.The merged section now mixes a GitHub-linked entry with website-hosted ones. That is safe and already precedented in five other sections —
docs.jsguards onrepoUrlper item (line 153), not per section.Verification
npm run docs— the same generation CI runs, clones and all — then a fullhugobuild:next-only version switcher.v0.1.0dropdown.Grafana Pluginsgone, three note cards remaining (the correct ones).layouts/projectdoc/baseof.htmlandstatic/images/*.pngreverted after the local build, sincebuild-with-docsregenerates them.🤖 Generated with Claude Code