docs: update zh-tw (#265)

Reviewed-on: https://gitea.com/gitea/docs/pulls/265
Reviewed-by: Lunny Xiao <[email protected]>
Co-authored-by: ifurther <[email protected]>
Co-committed-by: ifurther <[email protected]>
This commit is contained in:
ifurther
2025-09-03 21:00:35 +00:00
committed by techknowlogick
parent 908a27589d
commit cb462089e9
88 changed files with 3545 additions and 3423 deletions
@@ -10,31 +10,31 @@ aliases:
## 背景
自 2014 年 2 月 12 日编写了第一行代码以来,Gitea 已经发展成一个庞大的项目。
自 2014 年 2 月 12 日编写了第一行代码以来,Gitea 已经发展成一个庞大的项目。
因此,代码库变得越来越大。代码库越大,维护就越困难。
存在许多时的制,许多框架混合在一起,一些遗留代码可能会导致错误阻碍新功能的开发。
了使代码库更易于维护,使 Gitea 变得更好,开发人员牢记使用现代机制来重构旧代码。
存在许多时的制,许多框架混合在一起,一些遗留代码可能会导致错误阻碍新功能的开发。
了使代码库更易于维护,使 Gitea 变得更好,开发人员牢记使用現代機制来重构旧代码。
本文是关于重构代码库的指南集合。
本文是关于重构代码库的指南集合。
## 重构建议
- 设计更多关于未来的内容,而不仅仅解决当前问题。
- 设计更多关于未来的内容,而不僅僅解决当前问题。
- 减少模糊性,减少冲突,提高可维护性。
- 描述重构,例如:
- 什么需要重构。
- 什么需要重构。
- 如何解决旧问题。
- 重构的优点/缺点是什么。
- 只做必要的更改,尽量保留旧逻辑。
- 引入一些中间步骤,使重构更容易审查,完整的重构计划可以在几个 PR 中完成。
- 如果存在分歧,应该请 TOC(技术监督委员会)参与决策。
- 如果存在分歧,應該請 TOC(技术监督委员会)参与决策。
- 添加必要的测试以确保重构的正确性。
- 非错误重构优先在里程碑的开始时行,这样可以更容易地在发布之前发问题。
- 非错误重构优先在里程碑的开始时行,这样可以更容易地在發佈之前发问题。
## 审查和合建议
## 审查和合建议
- 重构的 PR 不应该长时间保持打开状态(通常 7 天),尽快行审查。
- 重构的 PR 尽快合,不被其他 PR 阻塞。
- 如果 TOC 没有异议,重构的 PR 可以在 7 天后由一名核心成员(非作者)批准后合
- 重构的 PR 不應該长时间保持打开状态(通常 7 天),尽快行审查。
- 重构的 PR 尽快合,不被其他 PR 阻塞。
- 如果 TOC 没有异议,重构的 PR 可以在 7 天后由一名核心成员(非作者)批准后合
- 如果最终结果良好,容忍一些不完美/临时的步骤。
- 如果重构是必要的,容忍一些回归错误,尽快修复错误。
- 如果重构是必要的,容忍一些回归错误,尽快修复错误。