summaryrefslogtreecommitdiff
path: root/Documentation/source/zh_TW/contributing.rst
diff options
context:
space:
mode:
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