Skip to content

Refactor and optimize Cangjie language skills documentation#23

Draft
Copilot wants to merge 6 commits into
mainfrom
copilot/refactor-skills-documentation
Draft

Refactor and optimize Cangjie language skills documentation#23
Copilot wants to merge 6 commits into
mainfrom
copilot/refactor-skills-documentation

Conversation

Copilot AI commented Feb 28, 2026

Copy link
Copy Markdown
Contributor

Skills docs had verbose/redundant content wasting context, missing important content from source docs, and minor inaccuracies.

Condensed verbose content

  • stdx/SKILL.md: 825 → 506 lines. Removed duplicate "快速上手示例" section, redundant ClientBuilder config block, verbose Person serialization example, collapsed JSON type table and logger examples.

Fixed missing content

  • error_handle/SKILL.md: Runtime exceptions table expanded from 5 → 11 entries (ArithmeticException, IndexOutOfBoundsException, IllegalStateException, NullPointerException, UnsupportedException, TimeoutException)
  • basic_data_type/SKILL.md: Added String common methods (contains, split, replace, trimAscii, indexOf, etc.) and cross-reference to cangjie-std-string Skill
  • collections/SKILL.md: Added map.get("a") safe access returning ?V
  • macro/SKILL.md: Documented parseExprFragment/parseDeclFragment offset parameter semantics
  • struct/SKILL.md: Added code example for mut function this restrictions

Fixed inaccuracies

  • concurrency/SKILL.md: sleep() now correctly states "at least dur" guarantee; removed redundant description line
  • class/SKILL.md: Clarified sealed subclass inheritance rule (open 且不被 sealed 修饰), added match exhaustiveness note

Improved structure

  • basic_programming_concepts/SKILL.md: Added cross-references to cangjie-pattern-match, cangjie-error-handle, cangjie-function for topics covered there (match/try-catch/lambda)

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 5 commits February 28, 2026 17:21
- Remove section 14 (快速上手示例) which duplicated examples from sections 3/4
- Remove duplicate ClientBuilder configuration block in section 3
- Remove verbose custom type serialization example in JSON stream section
- Condense logger examples into one combined block
- Inline JsonValue type table and type judgment code block
- Trim redundant blank lines and verbose code comments throughout
- Renumber section 15 to 14

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…e access

- concurrency/SKILL.md: Add 'at least dur' sleep guarantee detail
- error_handle/SKILL.md: Expand runtime exceptions table with 6 more entries
- collections/SKILL.md: Add map.get() safe access info for HashMap

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- basic_data_type: add String repeat operator, common methods subsection, and API cross-reference
- basic_programming_concepts: add cross-references to related skills after break/continue section
- class: clarify sealed subclass inheritance rules and add match exhaustiveness note

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…on example

- Clarify parseExprFragment/parseDeclFragment Int64 parameter semantics
- Add code example for mut function this restrictions in struct skill

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: SunriseSummer <257439649+SunriseSummer@users.noreply.github.com>
Copilot AI changed the title [WIP] Refactor and optimize skills documentation for Cangjie Refactor and optimize Cangjie language skills documentation Feb 28, 2026
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.

2 participants