天天看點

Dapr 官方文檔中文翻譯 v1.5 版本正式釋出

作者:敖小劍 - Dapr Approver

經過 Dapr 中國社群十餘位貢獻者一個多月的努力,Dapr 官方文檔中文翻譯 v1.5 版本完成翻譯和審校,正式釋出并上線 Dapr 官網。

通路方式

v1.5 版本的中文文檔在3月19日已經正式釋出并上線 Dapr 官網,請打開 Dapr 文檔的官方網站:

https://docs.dapr.io/

在右上角的下拉框中依次選擇 “v1.5” 和 “簡體中文”:

Dapr 官方文檔中文翻譯 v1.5 版本正式釋出

或直接進入網址:https://v1-5.docs.dapr.io/zh-hans/

Dapr 官方文檔中文翻譯 v1.5 版本正式釋出

釋出内容

本次釋出的翻譯内容包含 Dapr 官方英文文檔 v1.5 版本對應的幾乎所有内容:

Dapr 官方文檔中文翻譯 v1.5 版本正式釋出

例外的是圖中所示的 “developing-applications” 和 “reference” 兩個大章節。

特别說明:在 Dapr 的官方文檔中,有三個章節由于内容超級多,一直是 Dapr 中文文檔翻譯工作中最艱辛的部分,因工作量巨大被戲稱為"三座大山"。在 v1.5 版本的翻譯工作中,除了更新正常内容之外,重點完成了 “operations” 章節的翻譯和審校。至此"三座大山"中的第一座被推翻,另外 “developing-applications” 章節翻譯接近完成隻待審校, “reference” 翻譯過半,進度喜人。

預期在 v1.6 版本中,中文翻譯小組将完成 “developing-applications” 章節内容的審校。預期在 v1.7 或 v1.8 版本中完成 “operations” 章節的翻譯和審校,徹底推翻"三座大山",完成 Dapr 官方文檔的完整翻譯。

特别鳴謝

Dapr 中國社群在去年底重組了中文文檔翻譯小組,重新開機了 Dapr 翻譯文檔的翻譯工作。

以下是參與 Dapr 中文文檔 v1.5 版本翻譯和審校的貢獻者名單:

Dapr 官方文檔中文翻譯 v1.5 版本正式釋出

謝謝各位小夥伴的辛苦努力和無私奉獻!

翻譯進度說明

借此機會,回答社群同學經常問到的兩個和中文文檔翻譯進度有關的問題。

為什麼一直沒有完成完整的中文文檔翻譯?

Dapr 中文文檔翻譯工作中遇到的最大挑戰,就是 Dapr 英文文檔随着版本的推進,内容不斷的更新,同時有大量新的文檔加入。是以中文文檔翻譯的進度一直處于苦苦追趕的狀态。期間由于英文文檔新内容加入的速度快于中文文檔翻譯的速度,甚至出現了翻譯完成度不升反降的局面,如下圖中 v1.1 到 v1.4:

Dapr 官方文檔中文翻譯 v1.5 版本正式釋出

本次釋出的 v1.5 版本在小夥伴的努力下翻譯量突發猛進,在完成 “operations” 章節之後成功将翻譯完成度推高到 80% 。但由于 v1.6 英文文檔的大量更新和新增,在 v1.6 中翻譯完成度已經自動下降到70%。

為什麼翻譯版本一直落後于 Dapr 最新釋出版本?

中文文檔翻譯一般會比 Dapr 最新釋出的版本低 2 個小版本,比如目前 Dapr 最新穩定版本是 v1.6,v1.7 釋出了預覽版本即将釋出正式版本,而中文文檔翻譯才剛釋出 v1.5 版本。這裡面有三個主要原因:

  • 官方英文文檔進度延後:Dapr 的官方英文文檔的更新和新增工作,并不是在 Dapr 版本釋出時同步完成,而是在 Dapr 版本釋出之後陸陸續續的進行更新和補充,這個過程通常會持續到 Dapr 下一個小版本的釋出。即官方英文文檔本身就落後一個小版本。
  • 中文文檔翻譯進度延後:為了避免在翻譯過程中,因為英文文檔更新造成的幹擾,避免出現重複或無效的翻譯,通常會在英文文檔比較穩定之後再全面開始這一個版本的中文翻譯工作,考慮翻譯和審校需要的時間,一般為1-2個月。是以中文文檔也會延後一段時間,大體也是落後一個小版本。
  • “三座大山"工作量驚人:前面提到的 Dapr 文檔中 “operations” / “developing-applications” / “reference” 這三個章節内容量超大,對翻譯進度有緻命影響。

總結:在"三座大山"被推翻之前,Dapr 中文文檔依然會維持目前比 Dapr 釋出版本低 2 個小版本的狀态。預計未來在 v1.6/v1.7/v1.8 版本中能夠陸續完成 “developing-applications” / “reference” 這兩個超大章節的翻譯。在這個基礎上,我們才有機會去同步跟進 Dapr 官方英文文檔的進度。

歡迎加入

當然,所有的一切都建立在 Dapr 中國社群中文文檔翻譯小組的努力基礎上。為了更好更快的達成目标,讓 Dapr 可以更好的在中國技術社群推廣,讓英文不是特别好的部分同學可以更友善的查閱文檔,我們真誠的希望有更多的社群朋友加入到 Dapr 的文檔翻譯工作中來。

Dapr v1.6 版本的翻譯工作即将啟動,新的征程,期待您的加入!

加入方式:

  • 通路 https://github.com/dapr-cn/docs 了解詳情
  • 在 Dapr 各社群群中聯系我們申請加入翻譯小組

繼續閱讀