summaryrefslogtreecommitdiff
path: root/Documentation/source/zh_TW/contributing.rst
diff options
context:
space:
mode:
authorBertrand Yuan <me@bertyuan.com>2026-04-27 20:52:54 +0800
committerBertrand Yuan <me@bertyuan.com>2026-04-27 20:53:14 +0800
commitdbb5e791f0c228369605d126dd590962ebe1eddc (patch)
tree8c83fc84bd9547630e6733929dec77e102e055a8 /Documentation/source/zh_TW/contributing.rst
parent658798b3a2378bb6df16cfbb16d707c6fb719e1e (diff)
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>
Diffstat (limited to 'Documentation/source/zh_TW/contributing.rst')
-rw-r--r--Documentation/source/zh_TW/contributing.rst38
1 files changed, 38 insertions, 0 deletions
diff --git a/Documentation/source/zh_TW/contributing.rst b/Documentation/source/zh_TW/contributing.rst
new file mode 100644
index 0000000..8b12920
--- /dev/null
+++ b/Documentation/source/zh_TW/contributing.rst
@@ -0,0 +1,38 @@
+貢獻指南
+========
+
+工作流程
+--------
+
+1. 先判斷變更屬於哪個子系統。
+2. 閱讀相鄰實作和測試。
+3. 確認變更是否影響執行期行為、schema、UI、文件或維運流程。
+4. 保持 patch 聚焦,不做無關重構。
+
+提交訊息
+--------
+
+推薦格式:
+
+.. code-block:: text
+
+ <type>(<scope>): <short summary>
+
+常用類型包括 ``build``、``ci``、``docs``、``feat``、``fix``、``perf``、``refactor`` 和 ``test``。摘要使用祈使句、現在式,不以句號結尾。
+
+程式碼完整性
+------------
+
+* 發布版本時優先使用簽名 commit 和簽名 tag。
+* 不提交密鑰、本機資料庫狀態或建置產物。
+* 依賴變更應和原始碼變更一樣認真審查。
+* 非平凡變更應在分支上開發,並通過測試和文件建置。
+
+提交前檢查
+----------
+
+.. code-block:: bash
+
+ pnpm lint
+ pnpm test
+ make -C Documentation html