Lumen Docs 開源文件平台 · 規劃輸入Lumen Docs open documentation platform · planning input

翻譯做得完,
但沒人接得住
下一個版本
The translations
get finished. Nobody
catches the next release.

這份報告不是社群年報,而是明年度翻譯制度、審閱流程、發行節奏三項規劃工作的資料基礎。所有數字皆為示範用途。This is not a community annual report. It is the data behind three pieces of next year’s planning: the translation policy, the review process, and the release rhythm. Every figure here is illustrative.

示範資料 · 非真實專案Illustrative data · not a real project 資料期間 示範年度Period: a sample year Paper brief 版型預覽Paper brief template preview

報告定位WHAT THIS BRIEF IS

問題不在翻譯品質,在交接The problem is not translation quality. It is handover.

社群目前的痛點多半被描述成「翻譯落後」。但把資料攤開之後會發現,落後的不是翻譯本身,而是原文改版之後沒有人知道哪幾頁失效了The community usually describes the pain as “translation is behind”. Laid out, the data says something else: what is behind is not the translating but the fact that nobody learns which pages went stale when the source changed.

觀察到的現象What was observed 對制度的意義What it means for policy 頁數Pages
首次翻譯完成後未再更新Translated once, never updated since缺少原文變更通知機制No notification when the source changes180
翻譯與原文版本相差兩個大版Two major versions behind the source讀者看到的是舊行為Readers are shown behaviour that no longer exists64
審閱者僅一人的語系Locales with a single reviewer單點依賴,請假即停擺One point of failure; one holiday stops the locale3
與原文同版發行的語系Locales released in step with the source流程已經成立,可作為範本The process already works here; copy it2

唯一需要立刻處理的是最後兩列:一個是風險,一個是可以複製的做法。Only the last two rows need acting on now: one is a risk, the other is a practice worth copying.

01

本報告的三個章節THE THREE CHAPTERS

資料如何對應到規劃工作How the data maps onto the planning work

章節 01CHAPTER 01
翻譯覆蓋Coverage
哪些頁面該翻、哪些不該翻、失效怎麼被發現。Which pages should be translated, which should not, and how staleness gets noticed.
章節 02CHAPTER 02
審閱人力Reviewers
誰在審、審多久、單點依賴集中在哪裡。Who reviews, how long it takes, and where the single points of failure sit.
章節 03CHAPTER 03
發行節奏Release rhythm
原文與譯文如何對齊,以及要不要對齊。How source and translation line up, and whether they should.
620
文件頁面總數pages in the documentation
9
已開設的語系locales opened so far
244
已翻譯但已失效的頁面
(示範數字)
translated pages now stale
(illustrative)
31%
與原文同版的比例in step with the source
02

章節 01 · 供 翻譯制度規劃 使用CHAPTER 01 · FEEDS THE TRANSLATION POLICY

01

覆蓋率是假的,
同步率才是真的
Coverage is the flattering
number. Sync is the true one.

一頁翻過就永遠算數,是目前所有統計最大的問題。Counting a page forever because it was translated once is the flaw underneath every current statistic.

03

兩種算法TWO WAYS TO COUNT

同一批文件,兩個差很多的數字The same pages, two very different numbers

目前對外宣稱的覆蓋率COVERAGE, AS PUBLISHED
78%
分母是全部頁面,分子是「曾經被翻譯過」的頁面。All pages below the line; pages ever translated above it.
與原文同版的比例IN STEP WITH THE SOURCE
31%
分子改成「翻譯版本等於當前原文版本」,數字掉了 47 個百分點。Change the numerator to “matches the current source version” and the figure drops 47 points.

兩個數字都沒有算錯,差別在於承不承認文件會改版
註:本頁所有數字為版型示範用,並非任何真實專案的統計。
Neither number is miscalculated. The difference is whether you admit that documentation changes.
Note: every figure on this page is illustrative, and describes no real project.

建議做法Recommendation
對外只公布同步率,覆蓋率降為內部指標。同時在建置流程加入一個檢查:原文檔案更新時,把對應的譯文標記為待更新,並自動開一則 issue。Publish only the sync rate; demote coverage to an internal metric. Add one check to the build: when a source file changes, mark its translations as pending and open an issue automatically.
04

失效的速度HOW FAST IT GOES STALE

一次改版,平均讓多少頁翻譯過期How many translated pages one release expires

3.4×

每完成一頁新翻譯的同時,平均有 3.4 頁既有翻譯因為原文改版而失去同步。示範數字,用來說明趨勢而非精確值。For every page newly translated, 3.4 already-translated pages fall out of sync because the source moved. An illustrative figure, meant to show direction rather than precision.

這個比例說明的是方向:只靠增加譯者,覆蓋率會上升,同步率不會。要改的是通知機制,不是人力配置。The ratio points one way: adding translators raises coverage and leaves sync where it was. What needs fixing is the notification, not the headcount.

時間敏感Time-sensitive
下一個大版發行前完成標記機制,否則這一批新翻譯會在發行當天同時過期,等於白做。Ship the staleness marker before the next major release, or this batch of new translations expires on release day and the work is wasted.
05

審閱人力分布WHERE THE REVIEWERS ARE

三個語系靠一個人撐著Three locales rest on one person each

語系 ALocale A
6 人6
語系 BLocale B
4 人4
語系 CLocale C
3 人3
語系 DLocale D
2 人2
語系 E · F · GLocales E · F · G
各 1 人1 each

最後一列不是「人少」,是沒有備援。審閱者一旦停止參與,該語系的發行就停在原地,而且沒有任何流程會發現這件事。The last row is not “short-staffed”, it is unbacked. If that reviewer stops, the locale stops releasing, and no process in place would notice.

06

寫進明年度規範FOR NEXT YEAR’S POLICY

五條可以直接執行的要求Five requirements you can act on as written

01對外只公布同步率,覆蓋率轉為內部指標兩個數字相差 47 個百分點,對外用寬鬆的那個等於自我欺騙Publish the sync rate only; keep coverage internalThe two differ by 47 points, and publishing the generous one is self-deception
02原文更新時自動標記對應譯文為待更新目前失效完全靠讀者回報,平均延遲以月計Mark translations pending automatically when the source updatesStaleness is currently found by readers, at a delay measured in months
03每個語系至少兩名審閱者才列入正式發行三個語系目前是單人維持Require two reviewers per locale before it counts as officially releasedThree locales are held up by one person each today
04明確定義哪些頁面不需要翻譯變動最頻繁的頁面同時也是翻譯最容易過期的頁面Say explicitly which pages are not to be translatedThe pages that change most often are the ones whose translations expire first
05發行說明中標示每個語系的同步狀態讀者現在無法判斷自己看到的是不是舊版行為State each locale’s sync status in the release notesA reader currently cannot tell whether they are reading last year’s behaviour
07

待社群決定FOR THE COMMUNITY TO DECIDE

五個需要先有共識的問題Five questions that need agreement first

08

下一步NEXT

先讓失效
被看見,
再談覆蓋率。
Make staleness
visible first.
Then talk about coverage.

標記機制一週可以做完,制度討論需要一個月。
兩件事可以同時開始,順序不能顛倒。
The marker takes a week to build; the policy conversation takes a month.
They can start together — but not in the other order.

Paper brief 版型預覽 · 示範內容Paper brief template preview · illustrative content monomind ai lab Hi Ted, Meet Lisa 製作Made with Hi Ted, Meet Lisa