nacos-java-sdk-doc

Align Nacos Java SDK usage docs with actual Java interfaces.

115|205|Updated Jul 20, 2018
One-click install
npx skills add https://github.com/nacos-group/nacos-group.github.io --skill nacos-java-sdk-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nacos-java-sdk-doc
Source: https://github.com/nacos-group/nacos-group.github.io/tree/main/.agents/skills/nacos-java-sdk-doc
Command: npx skills add https://github.com/nacos-group/nacos-group.github.io --skill nacos-java-sdk-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Updates Nacos Java SDK usage documentation by comparing Java Client interfaces with usage.md, then adding/removing APIs and overloads while preserving existing descriptions and examples.

Core Features & Use Cases

  • Automates synchronization of new APIs and overloads between the Java interfaces and the next-version usage.md to keep docs current.
  • Detects removed overloads and marks deprecated signatures to prevent outdated documentation.
  • Generates a changelog-style report highlighting new APIs, new overloads, and removals to guide manual updates.

Quick Start

Run the comparison script against your local nacos repository and the docs under src/content/docs/next to produce a change plan for the next release version.

Frequently Asked Questions about nacos-java-sdk-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Nacos Java SDK documentation with API changes?

Syncing Nacos Java SDK documentation involves comparing Java Client interfaces against usage.md to identify new APIs and overloads, then updating the docs while preserving existing descriptions and examples. It ensures the SDK documentation matches the actual Java interfaces.

How does comparing Java interfaces with usage.md keep SDK docs current?

Comparing Java interfaces with usage.md keeps SDK docs current by detecting NEW APIs, NEW OVERLOADS, and REMOVED OVERLOADS from the Nacos Java API source. It generates a changelog-style report to guide manual updates and prevent outdated documentation.

Can I detect removed overloads and deprecated signatures in Nacos Java SDK docs?

Yes, you can detect removed overloads and mark deprecated signatures in Nacos Java SDK docs. The comparison process identifies removed overloads against the Nacos Java API source to prevent outdated documentation from persisting in the next-version usage.md.

What is the best way to update Nacos Java SDK docs for the next release version?

The best way to update Nacos Java SDK docs for the next release is running a comparison script against the Nacos repository's api/src/main/java and the next-version docs at src/content/docs/next. This produces a change plan highlighting additions and removals.

Do I need access to the Nacos repository to compare Java API source files?

Yes, you need access to the Nacos repository's api/src/main/java directory and the next-version docs located at src/content/docs/next. These paths are required to compare the actual Java interfaces with the usage.md documentation.

Does Nacos Java SDK documentation sync support both English and Chinese next-version docs?

Yes, Nacos Java SDK documentation sync supports both English and Chinese next-version docs. It aligns the usage documentation with actual Java interfaces for both language versions under the src/content/docs/next directory structure.