Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
85 changes: 85 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
# SkyWalking Website - AI Assistant Guide

## Git Commit Rules
- Do NOT add `Co-Authored-By` with Claude or any AI assistant in commit messages.

## Release Event Post

Event posts live in `content/events/<slug>/index.md`.
Slug format: `release-apache-skywalking-<component>-<version>` with dots replaced by dashes (e.g. `release-apache-skywalking-java-agent-9-6-0`).

### Frontmatter
```yaml
---
title: Release Apache SkyWalking <Component Name> <VERSION>
date: YYYY-MM-DD
author: SkyWalking Team
description: "Release Apache SkyWalking <Component Name> <VERSION>."
---
```

### Body
1. Opening: `SkyWalking <Component Name> X.X.X is released. Go to [downloads](/downloads) page to find release tars.`
2. `Changes by Version` header
3. Version number with `------------------` underline
4. Bullet list of user-facing changes from the source repo's `CHANGES.md` at the release tag. Exclude dependency bumps, build-only, and test-only items.
5. Closing: `All issues and pull requests are [here](<github milestone link>)`

## data/releases.yml Update

### Link rules
- **Latest version** (top entry): uses `https://www.apache.org/dyn/closer.cgi/skywalking/...` for download and `https://downloads.apache.org/skywalking/...` for asc/sha512.
- **Older versions**: use `https://archive.apache.org/dist/skywalking/...` for all links (download, asc, sha512).
- When adding a new version, insert it at the top and demote the previous latest version's links to `archive.apache.org`.

### URL pattern
All components follow: `skywalking/<url-path-segment>/<version>/<artifact-filename>`

### Component reference

| Component | URL path segment | Artifact prefix | Source v-prefix | Dist v-prefix |
|-----------|-----------------|-----------------|-----------------|---------------|
| SkyWalking APM | (version only) | `apache-skywalking-apm-` | yes | yes |
| Java Agent | `java-agent/` | `apache-skywalking-java-agent-` | no | yes |
| Python Agent | `python/` | `skywalking-python-` | yes | yes |
| Go Agent | `go/` | `apache-skywalking-go-` | yes | yes |
| NodeJS Agent | `node-js/` | `skywalking-nodejs-` | yes | no |
| Rust Agent | `rust/` | `skywalking-` | yes | yes |
| PHP Agent | `php/` | `skywalking_agent-` | yes | yes |
| Client JavaScript | `client-js/` | `skywalking-client-js-` | yes | yes |
| Ruby Agent | `ruby/` | `skywalking-ruby-` | yes | yes |
| Nginx LUA Agent | `nginx-lua/` | `skywalking-nginx-lua-` | yes | yes |
| Satellite | `satellite/` | `apache-skywalking-satellite-` | yes | yes |
| Rover | `rover/` | `apache-skywalking-rover-` | yes | yes |
| CLI | `cli/` | `skywalking-cli-` | yes | yes |
| Kubernetes Helm | `kubernetes/` | `skywalking-helm-` | yes | (source only) |
| SWCK | `swck/` | `skywalking-swck-` | yes | yes |
| BanyanDB Server | `banyandb/` | `skywalking-banyandb-` | yes | yes |
| BanyanDB Java Client | `banyandb-java-client/` | `apache-skywalking-banyandb-java-client-` | yes | yes |
| BanyanDB Helm | `banyandb-helm/` | `skywalking-banyandb-helm-` | yes | (source only) |
| Eyes | `eyes/` | `skywalking-license-eye-` | yes | yes |
| Infra E2E | `infra-e2e/` | `skywalking-e2e-` | yes | yes |

### Date format
Use `Mon. DDth, YYYY` with ordinal suffixes: 1st, 2nd, 3rd, all others th (e.g. `Feb. 16th, 2026`).

## data/docs.yml Update

When releasing a new version, update the component's `docs` section:

1. **Update `Latest`**: change its `commitId` to the new release tag's dereferenced commit SHA (for annotated tags, dereference with `gh api repos/apache/<repo>/git/tags/<tag-sha> --jq '.object.sha'`).
2. **Add new versioned entry**: insert a `v<VERSION>` entry right after `Latest` with the same commitId and link pattern `/docs/<repo-slug>/v<VERSION>/readme/`.
3. **Keep old versions** as-is.

### Docs entry types
Components use two styles in docs.yml:
- **Hugo-hosted docs** (have `repoUrl`): use `/docs/<repo-slug>/<version>/readme/` links with `commitId`. These have `Next`, `Latest`, and versioned entries.
- **GitHub-linked docs** (no `repoUrl`): use direct GitHub links like `https://github.com/apache/<repo>/tree/v<VERSION>`. These only have versioned entries, no `Latest`/`Next`.

### Getting the commitId
```bash
# Get tag object SHA
TAG_SHA=$(gh api repos/apache/<repo>/git/ref/tags/v<VERSION> --jq '.object.sha')
# Dereference annotated tag to actual commit
COMMIT_SHA=$(gh api repos/apache/<repo>/git/tags/$TAG_SHA --jq '.object.sha')
```
29 changes: 29 additions & 0 deletions content/events/release-apache-skywalking-java-agent-9-6-0/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
---
title: Release Apache SkyWalking Java Agent 9.6.0
date: 2026-02-16
author: SkyWalking Team
description: "Release Apache SkyWalking Java Agent 9.6.0."
---

SkyWalking Java Agent 9.6.0 is released. Go to [downloads](/downloads) page to find release tars.
Changes by Version

9.6.0
------------------

* Fix OOM due to too many span logs.
* Fix ClassLoader cache OOM issue with WeakHashMap.
* Fix Jetty client cannot receive the HTTP response body.
* Eliminate repeated code with HttpServletRequestWrapper in mvc-annotation-commons.
* Add the jdk httpclient plugin.
* Fix Gateway 2.0.x plugin not activated for spring-cloud-starter-gateway 2.0.0.RELEASE.
* Support kafka-clients-3.9.x intercept.
* Upgrade kafka-clients version in optional-reporter-plugins to 3.9.1.
* Fix AbstractLogger replaceParam when the replaced string contains a replacement marker.
* Fix `JDBCPluginConfig.Plugin.JDBC.SQL_BODY_MAX_LENGTH` was not working in some plugins.
* Bump up Lombok to v1.18.42 to adopt JDK25 compiling.
* Add `eclipse-temurin:25-jre` as another base image.
* Add JDK25 plugin tests for Spring 6.
* Ignore classes starting with "sun.nio.cs" in bytebuddy due to potential class loading deadlock.

All issues and pull requests are [here](https://github.com/apache/skywalking-java/milestone/10?closed=1)
5 changes: 4 additions & 1 deletion data/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,10 @@
link: /docs/skywalking-java/next/readme/
- version: Latest
link: /docs/skywalking-java/latest/readme/
commitId: fbbedd72aafdadd04f332a8c22bb91a422f9bd8d
commitId: 8c649c4d249cce327474fd117bb81ed48378e535
- version: v9.6.0
link: /docs/skywalking-java/v9.6.0/readme/
commitId: 8c649c4d249cce327474fd117bb81ed48378e535
- version: v9.5.0
link: /docs/skywalking-java/v9.5.0/readme/
commitId: fbbedd72aafdadd04f332a8c22bb91a422f9bd8d
Expand Down
30 changes: 24 additions & 6 deletions data/releases.yml
Original file line number Diff line number Diff line change
Expand Up @@ -202,15 +202,24 @@
icon: java-agent
description: The Java Agent for Apache SkyWalking, which provides the native tracing/metrics/logging/event/profiling abilities for Java projects.
source:
- version: 9.6.0
date: Feb. 16th, 2026
downloadLink:
- name: src
link: https://www.apache.org/dyn/closer.cgi/skywalking/java-agent/9.6.0/apache-skywalking-java-agent-9.6.0-src.tgz
- name: asc
link: https://downloads.apache.org/skywalking/java-agent/9.6.0/apache-skywalking-java-agent-9.6.0-src.tgz.asc
- name: sha512
link: https://downloads.apache.org/skywalking/java-agent/9.6.0/apache-skywalking-java-agent-9.6.0-src.tgz.sha512
- version: 9.5.0
date: Aug. 18th, 2025
downloadLink:
- name: src
link: https://www.apache.org/dyn/closer.cgi/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0-src.tgz
link: https://archive.apache.org/dist/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0-src.tgz
- name: asc
link: https://downloads.apache.org/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0-src.tgz.asc
link: https://archive.apache.org/dist/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0-src.tgz.asc
- name: sha512
link: https://downloads.apache.org/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0-src.tgz.sha512
link: https://archive.apache.org/dist/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0-src.tgz.sha512
- version: 9.4.0
date: Feb. 23rd, 2025
downloadLink:
Expand Down Expand Up @@ -257,15 +266,24 @@
- name: sha512
link: https://archive.apache.org/dist/skywalking/java-agent/9.0.0/apache-skywalking-java-agent-9.0.0-src.tgz.sha512
distribution:
- version: v9.6.0
date: Feb. 16th, 2026
downloadLink:
- name: tar
link: https://www.apache.org/dyn/closer.cgi/skywalking/java-agent/9.6.0/apache-skywalking-java-agent-9.6.0.tgz
- name: asc
link: https://downloads.apache.org/skywalking/java-agent/9.6.0/apache-skywalking-java-agent-9.6.0.tgz.asc
- name: sha512
link: https://downloads.apache.org/skywalking/java-agent/9.6.0/apache-skywalking-java-agent-9.6.0.tgz.sha512
- version: v9.5.0
date: Aug. 18th, 2025
downloadLink:
- name: tar
link: https://www.apache.org/dyn/closer.cgi/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0.tgz
link: https://archive.apache.org/dist/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0.tgz
- name: asc
link: https://downloads.apache.org/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0.tgz.asc
link: https://archive.apache.org/dist/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0.tgz.asc
- name: sha512
link: https://downloads.apache.org/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0.tgz.sha512
link: https://archive.apache.org/dist/skywalking/java-agent/9.5.0/apache-skywalking-java-agent-9.5.0.tgz.sha512
- version: v9.4.0
date: Feb. 23rd, 2025
downloadLink:
Expand Down