vitest-dev / docs-cn

Vitest 中文文档
https://cn.vitest.dev
MIT License
149 stars 71 forks source link

与官方文档进行同步 #14

Closed elonehoo closed 2 years ago

elonehoo commented 2 years ago

今天下午开始我会全力进行同步官方文档的任务,可能到时候会将各位的翻译直接照搬,有一个 commit 的覆盖问题,不知道各位是否在意这个事情?

@BTBMan @alexzhang1030 @ouduidui @baboon-king @jp-liu @zhangzhibang0309

ouduidui commented 2 years ago

没问题

elonehoo commented 2 years ago

嘿嘿嘿

elonehoo commented 2 years ago

我也是头一次干这个

alexzhang1030 commented 2 years ago

这是被 Vitest 官宣了?

jp-liu commented 2 years ago

我也是头一次干

elonehoo commented 2 years ago

这是被 Vitest 官宣了?

没有,昨天有一个大哥说,「我手动同步仓库有好多东西都没注意到,可以让我考虑一下使用别的社区的方案,我看了看很好玩,想着试试看」具体 https://github.com/elonehoo/cn.vitest.dev/issues/1

elonehoo commented 2 years ago

反正我的目标已经达成了。。。

elonehoo commented 2 years ago

我们学校有很多同学开始使用测试框架在写代码的时候增加单测了

alexzhang1030 commented 2 years ago

没事我也是第一个干,可以尝试多个方案

elonehoo commented 2 years ago

嘿嘿嘿

elonehoo commented 2 years ago

关于未来是否会变成官方翻译

我的回答是「无所谓,如果成为了那就是我毕业最好的礼物,没有成为也是我学习英语路上的一个巨大飞跃,按照 『Anthony Fu』的说法,这个仓库也只是 Vitest 中文文档的一个备选,说不定有很多选择呢,反正我是来学英语,然后去给 Veui 做英文文档的,不能在被 顾轶灵 挑刺儿了!!! 」

ouduidui commented 2 years ago

我也是来学英语的哈哈哈 刚好最近也在学vitest

alexzhang1030 commented 2 years ago

haha 我也是

elonehoo commented 2 years ago

你们的翻译我可是一条一条看过去,然后在思考为什么可以这样,我的翻译是哪里出现了问题

alexzhang1030 commented 2 years ago

你们的翻译我可是一条一条看过去,然后在思考为什么可以这样,我的翻译是哪里出现了问题

就是语句通顺与意思表达是否正确这两方面吧 vitest 官方的文档有的地方描述的也很模糊,我在看 vitest 文档的时候有些地方感觉也很奇怪

elonehoo commented 2 years ago

我之前翻译都是用一下他到底是干啥的,然后翻译

alexzhang1030 commented 2 years ago

我之前翻译都是用一下他到底是干啥的,然后翻译

我以后会参考这种方式,目前的我还是以官方的文档为准,如果有什么我想加的我会先去官方文档提一个 pr,合并后再来翻译哈哈

elonehoo commented 2 years ago

英语好是真的可以为所欲为啊

alexzhang1030 commented 2 years ago

别误解了,我的英文超级渣的 😢

baboon-king commented 2 years ago

支持

BTBMan commented 2 years ago

支持

elonehoo commented 2 years ago

@LoTwT ok,我想我找到目前最佳的办法,clone 官方仓库 docs 文件夹,在将其建立一个新的分支,翻译结束之后进行合并 大家觉得如何

ouduidui commented 2 years ago

@LoTwT ok,我想我找到目前最佳的办法,clone 官方仓库 docs 文件夹,在将其建立一个新的分支,翻译结束之后进行合并 大家觉得如何

可以

LoTwT commented 2 years ago

可以

alexzhang1030 commented 2 years ago

@LoTwT ok,我想我找到目前最佳的办法,clone 官方仓库 docs 文件夹,在将其建立一个新的分支,翻译结束之后进行合并 大家觉得如何

可以

elonehoo commented 2 years ago

失败了

elonehoo commented 2 years ago

其实同步之后,还是需要去查看什么地方未翻译的是吗

alexzhang1030 commented 2 years ago

其实同步之后,还是需要去查看什么地方未翻译的是吗

对啊,需要去看

elonehoo commented 2 years ago

这不是我想象的样子

elonehoo commented 2 years ago

我觉得这样还是在两个文档之间进行比对,并不是直接将尚未翻译的地方直接展示在文档中

alexzhang1030 commented 2 years ago

还是需要探索出一种方式,不然中文文档与英文文档不同步可能会为使用者造成不便。

elonehoo commented 2 years ago

在我刚才的实验之后,发现将「Vitest_dev/vitest/docs」变成一个分支之后,在进行合并,就将之前的翻译覆盖了

alexzhang1030 commented 2 years ago

由于 vitest 的文档与源码放在一起,我认为可以将同步的事情暂缓,目前由维护者手动进行同步。等等看 vitest 后续的变动或者大家找到更好的方案

elonehoo commented 2 years ago

我想我可以去其他社区求求经,看看他们的整一个流程是怎么样的,争取我可以给大家一个完美的体验

1wkk commented 2 years ago

嘿,我想也许可以使用 @docschina-bot 来进行同步,可以了解一下

elonehoo commented 2 years ago

我一直都有这个打算

最近一直在看 印记中文 但是并没有看到怎么使用这个机器人

elonehoo commented 2 years ago

嘿,我想也许可以使用 @docschina-bot 来进行同步,可以了解一下

如果有这个机会,还劳烦你们教授一下

antfu commented 2 years ago

24 我已经 Call @QC-L 了 👀

QC-L commented 2 years ago

这改动有点大,可能要基于英文的重新调整下

watonyweng commented 2 years ago

@elonehoo 让 @QC-L 指导一下我们如何操作吧,你意下如何?

elonehoo commented 2 years ago

他好像比较忙,在call一下?

watonyweng commented 2 years ago

@elonehoo @QC-L 已经配置好 @docschina-bot 了,不知道怎么操作的

elonehoo commented 2 years ago

不是很怕麻烦,能同步就好,人工同步会忽略太多东西了

QC-L commented 2 years ago

@elonehoo 邀请下 @docschina-bot 进仓库,给个 write 权限即可

watonyweng commented 2 years ago

@elonehoo 估计再忙,稍等一下吧

elonehoo commented 2 years ago

不好意思,杭州下雨了....

elonehoo commented 2 years ago

回来就淋湿了

QC-L commented 2 years ago

@elonehoo 自动同步接入好了,目前会自动同步到 dev 分支下 接下来,需要你把所有的文档同步到 dev 分支下。 建议每篇文档逐行检查,这样可以避免内容遗漏。

等你们把所有的文档迁移好,我再把自动同步迁移到 main 分支下

elonehoo commented 2 years ago

好!

elonehoo commented 2 years ago

有一个疑问,是翻译sync-doc分支下,还是dev分支的呢