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

MicrosoftReactor發表於2022-03-22
作者:敖小劍 - Dapr Approver

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

訪問方式

v1.5 版本的中文文件在3月19日已經正式釋出並上線 Dapr 官網,請開啟 Dapr 文件的官方網站:
https://docs.dapr.io/

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

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

釋出內容

本次釋出的翻譯內容包含 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 中文文件翻譯工作中遇到的最大挑戰,就是 Dapr 英文文件隨著版本的推進,內容不斷的更新,同時有大量新的文件加入。因此中文文件翻譯的進度一直處於苦苦追趕的狀態。期間由於英文文件新內容加入的速度快於中文文件翻譯的速度,甚至出現了翻譯完成度不升反降的局面,如下圖中 v1.1 到 v1.4:

本次釋出的 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 版本的翻譯工作即將啟動,新的征程,期待您的加入!

加入方式:

相關文章