From dbb5e791f0c228369605d126dd590962ebe1eddc Mon Sep 17 00:00:00 2001
From: Bertrand Yuan <me@bertyuan.com>
Date: Mon, 27 Apr 2026 20:52:54 +0800
Subject: docs: add comprehensive documentation for operations

This commit introduces a complete set of documentation files
covering various aspects of the project, including environment
setup, quality checks, command references, and architecture.
The documentation is structured to assist developers and
contributors in understanding the project's configuration,
workflow, and best practices.

Additionally, translations for Simplified and Traditional
Chinese have been added to ensure accessibility for a wider
audience. This enhances the overall usability and
maintainability of the project.

Signed-off-by: Bertrand Yuan <github@bertyuan.com>
---
 Documentation/source/index.rst | 83 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 Documentation/source/index.rst

(limited to 'Documentation/source/index.rst')

diff --git a/Documentation/source/index.rst b/Documentation/source/index.rst
new file mode 100644
index 0000000..1f7103b
--- /dev/null
+++ b/Documentation/source/index.rst
@@ -0,0 +1,83 @@
+Next Blog Documentation
+=======================
+
+Next Blog is a full-stack blog platform built with Next.js, Payload CMS,
+PostgreSQL, Drizzle ORM, better-auth, and Fuma Comments. This documentation
+tree describes the product intent, system architecture, runtime operations,
+frontend conventions, and contribution workflow for the repository.
+
+The structure intentionally follows a subsystem-oriented layout: top-level
+indexes introduce each area, while deeper pages describe concrete flows,
+interfaces, and operational responsibilities. Keep this page small; add new
+material under the nearest subsystem directory.
+
+Audience
+--------
+
+This documentation is written for:
+
+* maintainers who need to understand the shape of the codebase;
+* contributors who need repeatable setup and contribution rules;
+* operators who need environment, database, and release notes;
+* designers and frontend engineers who need UI conventions.
+
+Project Map
+-----------
+
+.. list-table::
+   :header-rows: 1
+   :widths: 24 56
+
+   * - Area
+     - Responsibility
+   * - ``src/app/(main)``
+     - Public site routes, layouts, API endpoints, feeds, and Open Graph images.
+   * - ``src/app/(payload)``
+     - Payload CMS admin routes and API bridge.
+   * - ``src/components``
+     - Shared UI, rich text rendering, layout sections, auth widgets, and forms.
+   * - ``src/lib``
+     - Application helpers for content access, metadata, validation, actions,
+       email, and client utilities.
+   * - ``src/server``
+     - Database connection, Drizzle schema, authentication, and comment storage.
+   * - ``src/payload``
+     - Payload collection definitions for posts, users, and media.
+   * - ``content``
+     - MDX content consumed by the Fumadocs content pipeline.
+   * - ``Documentation/source``
+     - Sphinx source files for this documentation set.
+
+Contents
+--------
+
+.. toctree::
+   :maxdepth: 2
+
+   introduction
+   getting-started
+
+.. toctree::
+   :maxdepth: 2
+
+   architecture/index
+
+.. toctree::
+   :maxdepth: 2
+
+   frontend/index
+
+.. toctree::
+   :maxdepth: 2
+
+   operations/index
+
+.. toctree::
+   :maxdepth: 2
+
+   contributing/index
+
+.. toctree::
+   :maxdepth: 2
+
+   reference/index
-- 
cgit v1.2.3