Skip to content

docs(site): consolidate platform-specific docs into unified guides#2708

Draft
yuyutaotao wants to merge 1 commit into
mainfrom
claude/wonderful-turing-226igc
Draft

docs(site): consolidate platform-specific docs into unified guides#2708
yuyutaotao wants to merge 1 commit into
mainfrom
claude/wonderful-turing-226igc

Conversation

@yuyutaotao

Copy link
Copy Markdown
Collaborator

Summary

Consolidates platform-specific documentation by merging separate "Introduction" and "Getting Started" pages into unified guides for each platform (Computer/PC Desktop, Android, iOS, HarmonyOS). This reduces documentation fragmentation and improves navigation structure.

Key Changes

  • Merged documentation files:

    • computer-introduction.mdx + computer-getting-started.mdxcomputer.mdx
    • android-introduction.mdx + android-getting-started.mdxandroid.mdx
    • ios-introduction.mdx + ios-getting-started.mdxios.mdx
    • harmony-introduction.mdx + harmony-getting-started.mdxharmony.mdx
    • Applied to both English (en/) and Chinese (zh/) documentation trees
  • Removed separate API reference pages (content will be integrated into main guides):

    • computer-api-reference.mdx
    • android-api-reference.mdx
    • ios-api-reference.mdx
    • harmony-api-reference.mdx
    • Removed from both language trees
  • Updated navigation structure (rspress.config.ts):

    • Simplified sidebar from separate "Introduction" + "Getting Started" + "API Reference" sections to single unified pages per platform
    • Changed section header from "Android/iOS/HarmonyOS" to "More platforms"
    • Updated internal links to point to consolidated pages with anchor references (e.g., #api-reference)
  • Updated cross-references throughout documentation:

    • api.mdx, automate-with-scripts-in-yaml.mdx, integrate-with-any-interface.mdx, quick-start.mdx, faq.md, and changelog.mdx updated to reference new consolidated page locations
    • Links now use anchor fragments for API reference sections instead of separate pages

Implementation Details

  • Each consolidated guide now includes:

    • Platform overview and features
    • Showcase section
    • System requirements/preparation steps
    • Playground trial instructions
    • Getting started walkthrough
    • API reference content (integrated as sections with #api-reference anchors)
    • Advanced usage and troubleshooting
  • Maintained all original content; no information was removed, only reorganized

  • Both English and Chinese documentation trees kept in sync

Validation

  • pnpm run lint (docs-only changes)

https://claude.ai/code/session_01Fg6vPKPGaBi8iSobKTUjCr

Merge each non-web platform's introduction, getting-started, and API
reference into one page (/android, /ios, /harmony, /computer) and group
them under a "More platforms" sidebar section. Web keeps its multi-doc
section unchanged.

- Each platform page now covers intro + setup + full API reference, with
  the API reference under a `## API reference {#api-reference}` heading.
- Update cross-links in api/faq/quick-start/automate/integrate/changelog
  (en + zh) to the new anchors.
- Add client redirects from the old *-introduction / *-getting-started /
  *-api-reference paths (en + zh) and repoint existing redirects.
- Point the homepage mobile CTA link to /android.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fg6vPKPGaBi8iSobKTUjCr
@yuyutaotao

Copy link
Copy Markdown
Collaborator Author

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