docs: update readme

Author: xiaoyu2er

README.md

@@ -0,0 +1,94 @@
+# Next.js i18n Documentation Project
+
+This is a monorepo project designed to sync with the official Next.js documentation and translate it into multiple languages. The project uses [Fumadocs](https://fumadocs.vercel.app) for documentation generation and includes a custom translation toolkit.
+
+## Features
+
+- 📚 Complete mirror of official Next.js documentation
+- 🌐 Multilingual support (currently English and Simplified Chinese)
+- 🔍 Full-text search with [Orama](https://oramasearch.com)
+- 🤖 AI-powered translation using the `@next-i18n/translate` package
+
+## Project Structure
+
+```
+next-i18n-docs/
+├── apps/
+│   └── docs/         # Next.js documentation site
+├── packages/
+│   └── translate/    # Translation utility package
+```
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18 or newer
+- pnpm 9.15.0 or newer
+
+### Installation
+
+```bash
+# Install dependencies
+pnpm install
+```
+
+### Development
+
+```bash
+# Run the development server
+pnpm dev
+
+# Open [http://localhost:3000](http://localhost:3000) to view the docs
+```
+
+## Translation
+
+This project includes a custom translation utility that can translate the Next.js documentation into multiple languages. Currently, it supports:
+
+- English (source)
+- Simplified Chinese (zh-Hans)
+- More languages can be added in the translation configuration
+
+Documentation content is stored in the `apps/docs/content` directory:
+
+- `content/en/` - Original English documentation (source of truth)
+- `content/zh-hans/` - Simplified Chinese translation
+- Additional languages can be configured in `translation.config.mjs`
+
+### Translate Content
+
+```bash
+# Set your OpenAI API key
+export OPENAI_API_KEY=your-openai-api-key
+
+# Run the translation process
+pnpm translate
+```
+
+## Building
+
+```bash
+# Build the translation package
+pnpm build:packages
+
+# Build the documentation site
+pnpm build:docs
+```
+
+## Search Index
+
+```bash
+# Update the search index
+pnpm update-search-index
+```
+
+## Learn More
+
+- [Next.js Documentation](https://nextjs.org/docs)
+- [Fumadocs Documentation](https://fumadocs.vercel.app)
+- For detailed information about the translation utility, see the [translate package README](./packages/translate/README.md)
+
+## License
+
+ISC

apps/docs/README.md

@@ -1,26 +1,70 @@
-# next-i18n-docs
+# Next.js i18n Documentation Site
 
-This is a Next.js application generated with
-[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
+This is the documentation site package for the Next.js i18n Documentation Project. It renders multilingual Next.js documentation using [Fumadocs](https://fumadocs.vercel.app).
 
-Run development server:
+## Quick Start
+
+Start the development server:
 
 ```bash
-npm run dev
-# or
+# From the root of the monorepo:
+pnpm dev
+
+# Or from this directory:
 pnpm dev
-# or
-yarn dev
 ```
 
-Open http://localhost:3000 with your browser to see the result.
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
 
-## Learn More
+## Directory Structure
+
+```text
+docs/
+├── content/           # Documentation content
+│   ├── en/            # English (source)
+│   └── zh-hans/       # Simplified Chinese
+├── messages/          # i18n message files
+│   ├── en.json
+│   └── zh-hans.json
+├── scripts/           # Utility scripts
+└── src/               # Source code
+    ├── app/           # Next.js App Router
+    ├── components/    # Shared components
+    ├── i18n/          # i18n configuration
+    ├── lib/           # Utilities
+    └── mdx/           # MDX components
+```
+
+For detailed information about features, translations, and more, please refer to the [project README](../../README.md).
+
+## Translation
+
+In this project, documentation content is stored in the `content` directory:
+
+- `content/en/` - Original English documentation (source of truth)
+- `content/zh-hans/` - Simplified Chinese translation
+- Additional languages can be configured in `translation.config.mjs`
+
+To update translations:
 
-To learn more about Next.js and Fumadocs, take a look at the following
-resources:
+```bash
+# From the root of the monorepo
+pnpm translate
+
+# Or using the translation package directly
+OPENAI_API_KEY=your-api-key pnpm translate
+```
+
+## Search Index
+
+The search functionality is powered by Orama. To update the search index:
+
+```bash
+pnpm update-search-index
+```
+
+## Learn More
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js
-  features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
-- [Fumadocs](https://fumadocs.vercel.app) - learn about Fumadocs
+- [Next.js Documentation](https://nextjs.org/docs) - official Next.js docs
+- [Fumadocs](https://fumadocs.vercel.app) - documentation framework used in this project
+- [Next.js i18n Documentation](https://github.com/nextjs/next.js/tree/canary/docs) - source content