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>

1 files changed, 53 insertions, 0 deletions

diff --git a/Documentation/source/reference/api.rst b/Documentation/source/reference/api.rst
new file mode 100644
index 0000000..85081aa
--- /dev/null
+++ b/Documentation/source/reference/api.rst
@@ -0,0 +1,53 @@
+API Reference
+=============
+
+Search Index
+------------
+
+Path
+   ``/api/search``
+
+Purpose
+   Provides search data for the frontend search experience.
+
+Rules
+   Return public published content only. Keep the response shape stable for the
+   search client.
+
+Comments
+--------
+
+Path
+   ``/api/comments/[...comment]``
+
+Purpose
+   Handles Fuma Comments operations.
+
+Rules
+   Authentication and authorization belong on the server side. Client code
+   should not decide comment privileges.
+
+Auth
+----
+
+Path
+   ``/api/auth/[...all]``
+
+Purpose
+   Handles better-auth routes for OAuth and session behavior.
+
+Rules
+   Keep provider configuration in ``src/server/auth`` and environment
+   validation in ``src/env.js``.
+
+Feed
+----
+
+Path
+   ``/rss.xml``
+
+Purpose
+   Publishes feed output for readers and feed clients.
+
+Rules
+   Include published content only and keep route references canonical.