Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Chrome Extensions 的翻译工作可以开始了!欢迎来认领翻译、校对 #2

Closed
Otto-J opened this issue Mar 22, 2022 · 1 comment

Comments

@Otto-J
Copy link
Member

Otto-J commented Mar 22, 2022

Chrome Extensions 目前推出了 v3 版本,欢迎大家一起来参与翻译、校对

image

流程:

  • 先翻译再校对,先认领再翻译
  • 为了避免重复翻译,多个重复翻译以第一个为主
  • 如果精力有限可以在 issues 里发通知,及时调整

想到了再补充,那让我们正式开始吧!😄

@Otto-J Otto-J pinned this issue Mar 22, 2022
@scarqin
Copy link
Collaborator

scarqin commented Mar 28, 2022

翻译流程

此流程遵循标准的 Github Flow,如已了解可直接略过。

Github Flow

整个翻译流程分为以下几个阶段:

  • 认领阶段
  • 翻译阶段
  • 校对阶段

认领阶段

如未认领文档就直接翻译,容易出现撞车的情况。

因此,在翻译前务必进行任务认领

认领任务,请到 Github Issues 认领想翻译的文档并留言。

选定要翻译的文档后,即可开始翻译。

翻译阶段

如需对某篇文章进行翻译。

fork 并 clone

先将 developer.chrome.com 的文档仓库 fork 为个人仓库(有增删改的权限)。

将 fork 后的仓库 download 至本地,如:

git clone https://github.com/<YOUR-GITHUB-NAME>/developer.chrome.com/

如下载过程过慢,可使用 depth 忽略以往的提交,这里不做过多赘述。

请基于 main 分支创建你的翻译分支。

例如:

git checkout -b translate/<docsname>

翻译

在 clone 好的文档中找到你所认领的文章,即可开始翻译。

翻译中请务必注意排版规范,尽量不要让校对者在文档格式方面浪费时间

翻译完成后,请 push 至个人仓库。

git add
git commit -m 'docs(cn): translate <文档名称>'
git push -u origin <翻译分支>

再创建 Pull Request 至 developer.chrome.com 的仓库。

注意:在创建 Pull Request 时,请尽量勾选允许其他人进行修改,便于快速修改及合并。

至此翻译阶段就结束了。

校对阶段

翻译完成请通知校对者,可在 PR 中添加 Reviewers。

校对中,如有疑问或翻译错误,校对者会给出建议。

Github 的 PR 的评论提供了 suggestion 的功能,校对者对某行给出校对建议后,如无异议,可以直接进行合并。

而如果改动点较多,需进行本地修改时,则在本地对对应的内容进行修改,并提交到个人仓库的翻译分支即可。

注意: 无需关闭 Pull Request,Pull Reuquest 会自动追踪你的修改。

完成

校对完成后,校对者会对 PR 进行 Approve 操作,并进行 Pull Request 的合并。

当你的 Pull Request 被合并后,则代表流程结束。

其他

如需再次翻译,或同时翻译多篇。

  • 一次 pr 尽量只有一篇文章的翻译,便于回溯
  • 保证个人仓库的 main 分支始终为最新
  • 每次翻译新文章时,请基于 main 分支拉取新分支

@Otto-J Otto-J closed this as completed in 7e1b83e Dec 21, 2022
docschina-bot pushed a commit that referenced this issue Mar 14, 2023
* move topics API questions out of FAQ

* move topics API questions out of FAQ into fedCM and fenced frames

* remove incorrect section

* remove redundant feedback links--move into docs

* move client hints content

* move final questions

* edit faq

* touchup

* touchup

* fix fig caption

* fix table headers

* fix table headers

* fix table headers

* fix table headers

* fix table headers, remove styles

* fix table headers, remove styles

* fix table headers, remove styles

* fix table headers, remove styles

* fix typo

* remove note in aside

Co-authored-by: Alexandra White <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants