跳至内容

为什么 VueUse 没有翻译?

VueUse 的文档没有翻译,而且我们**近期不打算正式维护任何翻译**。

以下是我们做出此决定的几个原因

重复和差异

文档翻译的一个众所周知的问题是很难保持更新。进行新的翻译意味着我们正在复制现有文档,并且需要大量工作来同步更改。

在 VueUse 中,我们将每个函数的代码、文档、演示和测试分组在同一个文件夹中(按函数分组而不是按类型分组)。这使得每个函数的上下文更加紧密,更容易阅读。但是,这也意味着如果我们想在同一个仓库中直接进行翻译,维护成本会呈指数级增长。

维护责任

VueUse 中有很多函数。维护代码和审查 PR 已经有很多工作要做,我们几乎没有足够的精力去做。对贡献者来说,一开始发送 PR 来添加翻译似乎很容易。但是,贡献者通常只进行一次性贡献(这在开源中完全没问题!)。原始翻译者可能并不总是存在,当英文文档更新时,保持翻译同步的责任通常会落在维护者身上。虽然我们有一个很棒的团队和社区,他们说不同的语言,但这并不意味着维护他人的翻译是轻而易举的。

维护重点

VueUse 是一个非营利性的开源项目。由于资源有限,我们希望更多地关注 VueUse 的逻辑和代码。我们正在尽力使函数尽可能直观和自解释。我们还希望更多地关注改进现有的英文文档和演示。

随着时间的推移,我们相信机器翻译会得到改进,用户可以根据需要使用翻译工具轻松地用自己的语言阅读文档。

社区翻译

也就是说,我们仍然对社区翻译持开放态度。如果您维护一个翻译,您可以打开一个讨论让我们知道,我们很乐意链接到社区翻译,只要它们维护良好并保持最新。感谢您!

根据 MIT 许可发布。