refactor: move package docs outside dist (#278)

Author: chenjiahan

.agents/skills/rstack-cli-best-practices/SKILL.md

@@ -16,7 +16,7 @@ Before any Rstack work, find and read the relevant Markdown documentation shippe
 
 Model knowledge can be outdated; the installed documentation is the source of truth for the project's Rstack version.
 
-1. Start with `node_modules/rstack/dist/docs/llms.txt`, then read only the linked pages relevant to the task before proposing or making changes.
+1. Start with `node_modules/rstack/docs/llms.txt`, then read only the linked pages relevant to the task before proposing or making changes.
 
 2. For exact CLI flags and behavior, also run `rs -h` or `rs <command> -h` when supported.
 

.gitignore

@@ -7,6 +7,7 @@
 node_modules
 dist/
 dist-*/
+/packages/rstack/docs/
 test-results
 doc_build
 

packages/create-rstack/template-common/AGENTS.md

@@ -2,6 +2,6 @@
 
 This project uses Rstack CLI as its JavaScript toolchain.
 
-- Before working with `rs` commands, `rstack.config.*` files, or imports from `rstack`, start with `node_modules/rstack/dist/docs/llms.txt`, then read only the linked pages relevant to the task.
+- Before working with `rs` commands, `rstack.config.*` files, or imports from `rstack`, start with `node_modules/rstack/docs/llms.txt`, then read only the linked pages relevant to the task.
 - For command details, use `rs -h` or `rs <command> -h`.
 - If the local documentation is unavailable, use https://rstack.rs/llms.txt and `rs <command> -h`.

packages/rstack/package.json

@@ -59,6 +59,7 @@
     "binding.cjs",
     "binding.d.cts",
     "dist",
+    "docs",
     "types",
     "THIRD_PARTY_NOTICES.md"
   ],

scripts/prepare-release.js

@@ -6,7 +6,7 @@ import path from 'node:path';
 const rootDir = path.resolve(import.meta.dirname, '..');
 const websiteDir = path.join(rootDir, 'website');
 const websiteDistDir = path.join(websiteDir, 'doc_build');
-const packageDocsDir = path.join(rootDir, 'packages/rstack/dist/docs');
+const packageDocsDir = path.join(rootDir, 'packages/rstack/docs');
 
 const run = (command, args) =>
   new Promise((resolve, reject) => {

website/docs/en/guide/ai.mdx

@@ -22,7 +22,7 @@ You can also copy the following content into your own `AGENTS.md`:
 ```markdown wrapCode title="AGENTS.md"
 This project uses Rstack CLI as its JavaScript toolchain.
 
-- Before working with `rs` commands, `rstack.config.*` files, or imports from `rstack`, start with `node_modules/rstack/dist/docs/llms.txt`, then read only the linked pages relevant to the task.
+- Before working with `rs` commands, `rstack.config.*` files, or imports from `rstack`, start with `node_modules/rstack/docs/llms.txt`, then read only the linked pages relevant to the task.
 - For command details, use `rs -h` or `rs <command> -h`.
 - If the local documentation is unavailable, use https://rstack.rs/llms.txt and `rs <command> -h`.
 ```

website/docs/zh/guide/ai.mdx

@@ -22,7 +22,7 @@ import { PackageManagerTabs } from '@rspress/core/theme';
 ```markdown wrapCode title="AGENTS.md"
 This project uses Rstack CLI as its JavaScript toolchain.
 
-- Before working with `rs` commands, `rstack.config.*` files, or imports from `rstack`, start with `node_modules/rstack/dist/docs/llms.txt`, then read only the linked pages relevant to the task.
+- Before working with `rs` commands, `rstack.config.*` files, or imports from `rstack`, start with `node_modules/rstack/docs/llms.txt`, then read only the linked pages relevant to the task.
 - For command details, use `rs -h` or `rs <command> -h`.
 - If the local documentation is unavailable, use https://rstack.rs/llms.txt and `rs <command> -h`.
 ```