跳到内容

为什么 VueUse 没有翻译?

VueUse 的文档没有翻译,并且我们不计划在近期内正式维护任何翻译

以下是我们做出此决定的一些考虑

重复和分歧

文档翻译的众所周知的问题之一是很难保持它们与时俱进。进行新的翻译意味着我们正在复制现有的文档,并且需要付出大量的努力来同步更改。

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

维护责任

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

维护重点

VueUse 是一个非营利开源项目。在资源有限的情况下,我们希望更多地关注 VueUse 的逻辑和代码。我们正在尽力使函数尽可能直观和不言自明。我们也希望更多地关注改进现有的英语文档和演示。

我们寄希望于随着时间的推移,机器翻译的改进,用户可以在需要时轻松地使用翻译工具以他们的语言阅读文档。

社区翻译

话虽如此,我们仍然对社区翻译持开放态度。如果社区翻译维护良好且是最新的,我们很乐意链接到它们。如果您正在维护翻译,您可以发起讨论告知我们。谢谢!

根据 MIT 许可证发布。