建议
Lunaria 的设计目标是帮助开源社区应对复杂的本地化项目,但仅靠工具本身只完成了其中一半的工作。
本页列出了我们针对改进您项目日常流程的建议,以更好地利用 Lunaria,提升贡献者和维护者的工作体验。
优先使用合并压缩提交
默认情况下,Lunaria 的基于 Git 的追踪系统会考虑每一个提交。如果多个提交被合并到主分支中,每个提交及其更改的文件可能会根据其标题和其他元数据而具有不同的状态。
因此,合并压缩提交 是一种保持 Lunaria 追踪系统可预测性的良好方式,通过让状态变化以每项拉取请求(Pull Request)为单位发生,而不是以每个提交为单位。
保持拉取请求(PR)内容简短
在频繁变动的高活跃度项目中,可能难以跟踪并检查本地化拉取请求是否在原始内容变更时遗漏了任何内容,而此时拉取请求仍处于审核状态。
通过在每个拉取请求中进行小范围修改,不仅更容易追溯任何遗漏的变更,还能让审阅者更愿意参与进来,确保本地化内容的质量。
向您的社区提供指导
许多潜在的贡献者可能并不熟悉 Lunaria、开源项目贡献,甚至两者都不熟悉!因此,全面记录整个流程至关重要,以确保新贡献者不会感到挫败,也避免维护者在引导他们成为有效贡献者时遇到困难。
Astro 文档的国际化指南 是一个可以参考的良好范例。总体而言,您的本地化文档应涵盖以下大部分主题:
- 开始所需的条件是什么?(工具、先前经验等)
- 本地化结构是怎样的?(内容位于何处,如何对 X 或 Y 进行本地化等)
- 贡献者如何参与?(最需要帮助的地方在哪里,如何找到可贡献的内容等)