为什么 VueUse 没有翻译?
VueUse 的文档没有翻译,并且**我们目前不计划正式维护任何翻译**。
以下是一些我们做出此决定的考虑因素
重复和差异
文档翻译众所周知的问题之一是难以保持更新。进行新的翻译意味着我们正在复制现有的文档,并且需要花费大量精力来同步更改。
在 VueUse 中,我们将每个函数的代码、文档、演示和测试分组在同一个文件夹中(按函数分组而不是按类型分组)。这使得每个函数的上下文更接近,更容易阅读。但是,这也意味着如果我们希望在同一个存储库中直接进行翻译,维护成本将呈指数级增长。
维护责任
VueUse 中有很多函数。维护代码和审查 PR 已经是我们几乎没有足够精力完成的工作量。对于贡献者来说,一开始提交 PR 添加翻译可能看起来很容易。但贡献者通常只进行一次性贡献(这在开源中完全没问题!)。当英文文档更新时,最初的翻译者可能并不总是在场,然后保持翻译同步的责任通常落在维护者肩上。虽然我们拥有一个很棒的团队和来自不同语言的社区,但这并不意味着维护其他人的翻译毫不费力。
维护重点
VueUse 是一个非营利性开源项目。在资源有限的情况下,我们希望更多地关注 VueUse 的逻辑和代码。我们正在尽最大努力使函数尽可能直观且易于理解。我们还希望更多地关注改进现有的英文文档和演示。
我们相信随着时间的推移,机器翻译会得到改进,用户可以根据需要使用翻译工具轻松地阅读他们自己语言的文档。
社区翻译
也就是说,我们仍然对社区翻译持开放态度。如果社区翻译维护良好且更新及时,我们很乐意链接到这些翻译。如果您正在维护某个翻译,可以打开一个讨论让我们知道。谢谢!