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