Skip to content

feat: .NET 8/10 support (v2.3.0) and a Hugo documentation site#617

Merged
wu-sheng merged 1 commit into
mainfrom
feat/net10-support-and-docs-site
Jun 27, 2026
Merged

feat: .NET 8/10 support (v2.3.0) and a Hugo documentation site#617
wu-sheng merged 1 commit into
mainfrom
feat/net10-support-and-docs-site

Conversation

@wu-sheng

Copy link
Copy Markdown
Member

Summary

Two related pieces of work, built and verified end-to-end:

  1. .NET 8/10 support for the agent (bump to v2.3.0).
  2. A complete, corrected documentation set published as a Hugo (Hextra) site for GitHub Pages.

Agent / build

  • Add net10.0 across the solution; drop the EOL netcoreapp3.1 / net5.0 / net6.0 targets. Active matrix is net8.0;net10.0, with netstandard2.0 kept as the compatibility floor on the foundational libraries (SkyApm.Core, SkyApm.Abstractions, SkyApm.Transport.Grpc, SkyApm.Transport.Kafka).
  • Add net10.0 conditional package blocks (Microsoft.Extensions.* / EntityFrameworkCore10.0.0) to every project that pins framework packages per-TFM; third-party versions unchanged.
  • Bump version to 2.3.0.
  • CI (net-ci-it.yml): install .NET 8 + 10 SDKs and test both target frameworks; modernize checkout/setup-dotnet to v4.

✅ Verified: full solution builds with 0 errors on both legs; dotnet test 7/7 pass on net8.0 and net10.0.

Docs

  • Rewrite/complete the docs: fix the long-stale sw6/v6sw8/v8, add a full configuration reference (every key, cross-checked against the config source), and new guides: installation & activation, transports (gRPC/Kafka), plugins, logging, CLI, troubleshooting. EN + 中文 config references kept in sync.
  • Publish as a Hugo site (Hextra theme, added as themes/hextra submodule) under content/, with navbar + auto sidebar + client-side search.
  • Deploy via .github/workflows/docs.yml → GitHub Pages (Pages Source = GitHub Actions). Site URL: https://skyapm.github.io/SkyAPM-dotnet/.
  • Rename CONTIBUTING.mdCONTRIBUTING.md; refresh README badges/links (GitHub Actions badge, mastermain, drop dead MyGet/Gitter/AppVeyor).
  • Positioning: framed as an independent .NET-ecosystem agent that reports to an Apache SkyWalking backend — not an ASF/SkyWalking sub-project.

✅ Verified: hugo --gc builds clean (23 pages), internal links resolve, search index generated.

Reviewer notes

  • One manual step for the docs site: repo Settings → Pages → Source = GitHub Actions (already set).
  • It's a large PR spanning build + docs — happy to split into two (net8/10 support vs docs site) if preferred.

🤖 Generated with Claude Code

Agent / build:
- Add net10.0 target framework across the solution; drop the EOL
  netcoreapp3.1/net5.0/net6.0 targets. Active matrix is net8.0 + net10.0, with
  netstandard2.0 kept as the floor on the foundational libraries.
- Add net10.0 conditional package blocks (Microsoft.Extensions.* /
  EntityFrameworkCore -> 10.0.0) to every project that pins framework packages
  per-TFM; third-party versions unchanged.
- Bump version to 2.3.0.
- CI: install .NET 8 + 10 SDKs and test both target frameworks; modernize
  checkout/setup-dotnet to v4.

Docs:
- Rewrite and complete the documentation: fix the stale sw6/v6 protocol to
  sw8/v8, add a full configuration reference (cross-checked against the config
  source), and add guides for installation, transports (gRPC/Kafka), plugins,
  logging, CLI, and troubleshooting. EN + CN config references kept in sync.
- Publish docs as a Hugo (Hextra theme) site under content/, deployed to GitHub
  Pages via .github/workflows/docs.yml.
- Rename CONTIBUTING.md -> CONTRIBUTING.md; refresh README badges/links.
- Position the project as an independent .NET-ecosystem agent that reports to an
  Apache SkyWalking backend (not an ASF/SkyWalking sub-project).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@wu-sheng wu-sheng added this to the 2.3.0 milestone Jun 27, 2026
@wu-sheng wu-sheng merged commit f7e3a5c into main Jun 27, 2026
1 check passed
@wu-sheng wu-sheng deleted the feat/net10-support-and-docs-site branch June 27, 2026 16:20
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