Scribe Origins 會先界定每份語言指南嘅範圍,對照相關且既有嘅來源去核實主張,標示真正嘅變體,並連結支持頁面嘅參考資料。呢啲 Scribe Origins 編輯標準亦會講明產品幫助、學習方法指引、更正處理,同埋未來翻譯點樣安排。
政策摘要
以讀者為先
每頁都由一條學習者真係可能會打或者會問嘅主問題開始。精確字眼可能會出現喺標題、開頭答案,同埋之後一段摘要入面。相關標題就會用讀者需要嘅自然變化形式:例如「乜嘢係…?」、「點樣…?」、「幾時應該…?」、「點解會…?」、「X 定 Y?」同「X 同 Y 有乜分別?」
冇目標關鍵字密度。某句精確短語一旦重複到唔自然,頁面就會冇咁有用。較強嘅做法係先直接答一小段,再配例子、例外、對比,同埋同周邊系統嘅連結。
證據
來源層級要睇主張類型而定:
連結唔係裝飾。頁面會解釋來源支持咩內容。列為參考嘅外部機構,並唔代表佢哋贊助或者認可 Scribe Origins。
語言內容
只有語言真係支持,先會用絕對式規則去講。否則指南會用「通常」、「喺中性對話入面」、「喺呢個語域入面」,或者「一個對初學者有用嘅預設值」呢類字眼。教學捷徑唔可以悄悄變成對所有真實句子嘅主張。
例子應該包括原文書寫系統、如果真係有幫助就加讀音或者轉寫,仲有英文意思。當禮貌、說話人關係、可動性、訊息狀態、地區或者社會場景會改變選擇時,嗰個語境就要放喺例子旁邊。
西班牙文 voseo、廣東話口語書寫、英式同美式英語、台灣同中國大陸用法、正式泰文、日本語敬語同韓語語體級別,都唔係某一個「全球唯一正確」變體嘅註腳。指南會講明自己教邊個變體,並標示學習者可能會遇到嘅其他形式。
羅馬化可以幫初學者連結字形同發音,但佢唔可以承載原書寫系統入面每一個分別。指南會標明所用羅馬化系統、保留母語書寫系統可見,並鼓勵讀者逐步離開轉寫,而唔係無限期依賴佢。
身份
文章由 Aiko、Grace 或 Kaito 署名撰寫,Scribe Origins 負責發佈同維護內容。認識作者頁面會介紹三位作者,以及佢哋各自撰寫嘅指南。
檔案唔會虛構母語者身份、學位、教學經歷、相片、引言或者社交連結。真實嘅審核者條目會講明個人角色同審核範圍——例如「審閱咗廣東話聲調同 Jyutping 部分」——而唔係暗示要對一頁長文入面每一句都負責。
產品文件
產品指南描述而家嘅應用程式,而唔係理想化路線圖。控制項、評分、持續儲存、離線行為、帳戶要求同跨遊戲進度都必須同讀者實際用緊嘅實作一致。截圖屬於第一手證據,但當介面有變化時,仍然需要圖注同定期審查。
如果某功能取決於帳戶狀態、語言可用性、瀏覽器支援或者網絡連線,嗰個條件就要清楚顯示。市場推廣說法唔可以凌駕已觀察到嘅行為。
更正
當有內容錯誤被報告或者被發現時,編輯團隊會先界定準確主張同語境,檢查而家嘅產品或者最相關來源,然後更正最細而完整嘅部分。相關例子、摘要、結構化資料同日期都會一併檢查,咁樣更正就唔會喺頁面其他位置留低互相矛盾嘅指引。
讀者可以喺 Scribe Origins 入面經支援功能報告問題。如果報告入面有句子、建議更正,同埋所涉及嘅語言變體或者語境,最容易跟進。
翻譯
發佈清單
Scribe Origins 點樣檢查語言學習內容 嘅實際答案,就係按頁面層級去審閱範圍、主張、例子、來源、搜尋呈現同維護。通過 HTML 驗證係必要但唔夠;可見答案仲要有用、界線清楚同可重現。
來源使用
揀最接近主張嗰個來源。Scribe Origins 而家嘅行為會對照應用程式同原始碼核實。官方語言標準同既有參考書支持標記法、字元資料同正式定義。經同行評審嘅研究支持一般學習原則。瀏覽器廠商就會支持佢哋自己產品嘅安裝步驟。
| 主張 | 首選證據 | 來源無法證明咩 |
|---|---|---|
| 有個控制項存在,或者會改變模式 | 而家嘅介面同相關應用程式原始碼 | 設計對每個學習者都係最理想 |
| 某個羅馬化或者字元特性 | 官方方案或者穩定技術參考 | 每個地區發音或者非正式拼寫 |
| 一個廣泛嘅記憶原則 | 經同行評審嘅綜述或者原始研究 | 保證到個人結果一定一樣 |
| 瀏覽器安裝步驟 | 而家瀏覽器廠商文件 | 所有作業系統版本都有一模一樣嘅選單 |
| 用法判斷 | 特定變體參考加上語境例子 | 所有說話者都一致偏好 |
來源連結應該放喺就近嘅來源段落附近,並解釋點解佢相關。長長嘅參考列表補唔返一句冇根據嘅句子,而一般學習論文亦唔應該被引用作為某個產品專用控制項嘅證明。
更正政策
| 嚴重程度 | 例子 | 編輯行動 |
|---|---|---|
| 嚴重 | 建議可能導致資料遺失、不安全操作,或者嚴重誤導 | 盡快移除或者更正,並核實鄰近主張 |
| 實質 | 文法規則、產品行為、地區標籤,或者答案鍵錯咗 | 更正內容、受影響例子、可見日期、結構化日期同 sitemap 日期 |
| 清晰度 | 正確文字有歧義,或者容易令人誤解 | 重寫並加對比或者限制;如果意思有實質提升,先更新日期 |
| 呈現 | 連結壞咗、版面問題、標籤無障礙有問題,或者元資料不一致 | 修正呈現,並檢查整個內容庫相同組件 |
| 排版 | 間距或者標點改動,意思完全唔變 | 直接更正,而唔好硬造一個新嘅實質日期 |
更正報告應該包括 canonical URL、最接近嘅標題、精確句子或者例子、預期形式、相關語言變體或者裝置,同埋證據。具體報告比起一句籠統講「頁面睇落唔對路」更容易重現同處理。
可見 SEO 政策
每份指南都會揀一條同讀者任務吻合嘅主問題。呢條短語可以自然咁出現喺標題、標題、開頭答案,同埋後面摘要入面。相關問題會有自己獨立部分。會用同義詞同文法變體,因為唔係個個讀者都會用一樣方式描述問題。
唔會加隱形段落、重複頁尾、地點列表,或者自動關鍵字區塊。搜尋語言必須對應讀者睇得到、用得到嘅內容。如果重複令文字拗口,句子就會刪走或者重寫。元資料只係摘要頁面;佢唔可以代替可見解釋。
呢條以人為本嘅規則係 Scribe Origins 點樣檢查語言學習內容 嘅一部分:搜尋相關性來自比薄薄一頁更完整咁回答問題,而唔係靠不斷重複同樣字眼。
翻譯 QA
機器翻譯可以幫手起草,但發佈之前要以地區層級審核意思、術語、搜尋用語同例子。一個翻譯咗嘅權威徽章,唔會令唔完整嘅翻譯變成權威。
參考框架
每份文法指南都會列出自己語言專屬參考資料。收錄來源唔代表 Scribe Origins 得到認可。