Re: 寫到 TOSSUG 郵件群的 HTML 規範實�@註解計畫的宣傳稿

我先講�@下，最近在忙MozCamp 跟換工�@跟搬家的事情，我要不就只能很粗淺地先掃�@遍、要不就是要晚點，但總之我現在快速掃過的基礎想法如下：

1. 盡量避免寫得太多，或許你可以看�@下有沒有哪些句子能精簡，因為長信少人看。當然這也要看你的目標，如果就是想找「會有�@性把這些看完」的人，那沒差。

2. "這裡想跟大家介紹 W3C HTML5 中文興趣小組關於 HTML 規範實�@註解的線上計畫，並鼓勵各位踴躍參加。" 這邊看起來是沒有把自己視為
TOSSUG 的�@員，而以�@個外來者的身分「鼓勵 TOSSUG 的成員參與」。看你會不會在意造成這樣的印象，�@般我不這樣寫，由其 TOSSUG 的
Ping �@開始也有參與推廣 HTML5 中文興趣小組，其實你就有很好的位置把自己當成他們的�@員。隨意改寫你參考：「

最近 W3C HTML5 中文興趣小組有個「HTML 規範實�@註解」計畫，希望能把規範裡的某些部份加上註解、直接連到 Gecko 或 Webit
的實做程式碼，以便幫助大家交叉參考程式碼與規範，蠻推薦大家參加。

」

我沒有把握這樣改寫有符合你的想法，但應該可以表達那個寫�@角色轉換上的意思。

3. 有些詞的確可能要修�@下，舉例：


之前 pingooo 在提到說要辦中文排版相關的工�@紡的時候，有說下午要來個 WebKit hackathon
來解這些問題，老實說我覺得這完全不可能，光是定位相關的程式碼可能就要花�@個下午了...

那時候是覺得如果要辦這樣的活動，事先的準備中�@定要先定位出問題程式碼在哪裡，所以這也是我現在做 CSS2.1
實�@註解[3]的�@個目標（不過我不能保證我會不會定位出問題就手癢送補丁了 :p）

>
> [3] http://www.w3.org/html/ig/zh/wiki/CSS2/impl

.
我稍微改寫�@下你看個意思：

之前 pingooo 在提到要辦中文排版工�@坊時，有說下午可以來個 WebKit hackathon
解決排版問題。老實說我覺得難度很高，如果要辦這樣的活動，為了方便抓問題，事先的準備中�@定要*先定位出規範相關的程式碼在哪裡*。這也是我現在做
CSS2.1 實�@註解[3]的�@個目標。

我改的重點：

   - 刪掉「不可能」相關的詞，�@方面這比較武斷、閱讀時感覺怪怪的，二方面其實你也補述了「要辦的話，有些條件要先成立」，那就不是不可能了。
   - 不見得會先定位出「問題程式碼」在哪裡，只要定位出某些區段的實做在哪裡，那問題就會好抓很多，而且事實上這跟你主題裡的 HTML5
   規範實做註解也比較相關。
   - 刪減�@部分篇幅
   - 重點粗體顯示

看個意思就好 我還在上班也不會花很多時間斟酌

這個計畫總地來講我還蠻有興趣的 對我這類人（不太寫，但確實想知道問題在哪裡，以及怎麼協助開發者修補東西）會很實用。


~Bob
2011/11/16 Kang-Hao (Kenny) Lu <kennyluck@csail.mit.edu>

> （注意：Cc 到 www-archive@w3.org 的信件會庫存在[1]，所以為完全公開。）
>
> [1] http://lists.w3.org/Archives/Public/www-archive/
>
> 哈囉 柏強
>
>
> 之前跟你提說我要寫�@個宣傳稿想麻煩你看�@下，看你會不會覺得有�@些內容不適
> 當（特別是提到 QQ 群之類的）或是其他怎麼樣更有機會讓別人參加之類的。反正
> 目的是吸引更多人參加這個計畫。以下是信的草稿：
>
>
> 主題：HTML 規範（與其他 Web 技術相關規範）的實�@註解計畫
> 內容：
>
> 各位 TOSSUG 的 hacker 們大家好：
>
>
> 這裡想跟大家介紹 W3C HTML5 中文興趣小組關於 HTML 規範實�@註解的線上計
> 畫，並鼓勵各位踴躍參加。
>
> == 什麼是 HTML 規範實�@註解計畫？==
>
> 這是由 W3C HTML5 中文興趣小組的 HTML 規範翻譯延伸出來的�@個計畫，基本上
> 就是把規範裡面的某些部份（在極端的情形下是每�@行）直接連到瀏覽器實�@的原
> 始碼的某些部份（範例：[2]，請點各瀏覽器圖示）。這裡原始碼使用的連結樣式
> 如下：
>
> Gecko:
>
> http://hg.mozilla.org/mozilla-central/annotate/945f64763a70/content/html/document/src/nsHTMLDocument.cpp#l823
> WebKit:
>
> http://trac.webkit.org/browser/trunk/Source/WebCore/dom/Document.idl?annotate=blame&rev=99612#L21
>
> 也就是在創造連結當下的最新版本的某�@行，用「當下最新版本」而不是「最新版
> 本」是避免行數在新的版本中會改變，而用「當下最新版本」基本上就是為當時的
> 原始碼照張像這樣。
>
> [2]
>
> http://www.w3.org/html/ig/zh/wiki/HTML5/impl#.E8.BC.B8.E5.85.A5.E4.B8.B2.E6.B5.81
>
> == 為什麼要做這樣的事情？==
>
> === 理由零 ===
>
> �@為�@個業餘人士，我目前透過這份規範翻譯 + 實�@註解已經貢獻了 Gecko +
> WebKit 了關於 CSS 實�@的三個小補丁。歡迎大家用業餘的時間來 hack
> Gecko/WebKit �@下，送個補丁，貢獻 Web 標準並給自己的技術人人生添加�@筆。
>
> === 理由�@ ===
>
> 幾個月的觀察下來，我發現 Gecko 跟 WebKit 在台灣並沒有開發者，我想這個主
> 因當然是商業理由。再來就是大型的專案本來要切入就不是很容易，Gecko/WebKit
> 的文檔也不夠詳細。
>
> 商業理由�@個小小的 hacker 基本上沒什麼辦法改變，但是在文檔上面，我認為
> HTML 規範實際上本身就是相當好的瀏覽器規格書。畢竟這份規格書就是反編譯 IE
> 的成果與 Gecko/WebKit �@意實�@部份的交集。
>
> 透過這份規範可以同時掌握�@界上大型開源專案前幾名中的兩個專案 — Mozilla
> 與 WebKit。如果之後有幸做 HTTP 規範的實�@註解的話，說不定還可以加上
> Apache。我在 COSCUP 聽 Linux Kernel 的 Talk 講說《Lions' Commentary on
> UNIX》是 Linux 歷史的起點，那我相信 HTML 規範也�@定是瀏覽器歷史上相當重要
> 的�@個里程碑。
>
> === 理由二 ===
>
> 我想短期之內台灣都不太有機會做 WebKit 做全職的開發者（整個 Adobe 做
> WebKit 全職的也只有兩個人），如果只是做暫時的 Gecko/WebKit 開發，能夠快
> 速的找到要開發部份的原始碼就變得很重要。
>
> 我常常聽到大陸 WebKit 社群的朋友在問「JS 的切入點在哪？」「要擴展 window
> 物件怎麼做？」之類的問題，希望之後這個規範實�@註解能夠把這種問題的答案記
> 載下來。
>
> 所以目前現有的實現註解已包括 JS 裡面 window、document 物件所用的 IDL，這
> 樣要找擴展 window、document 的方法就有個起始點了。任何商業公司如果有「如
> 果我要開發 WebKit，我大概會開發這個部份...」的計畫的話，歡迎跟我們說，我
> 們可以先行做那個部份的實�@註解。
>
> === 理由三 ===
>
> 之前 pingooo 在提到說要辦中文排版相關的工�@紡的時候，有說下午要來個
> WebKit hackathon 來解這些問題，老實說我覺得這完全不可能，光是定位相關的
> 程式碼可能就要花�@個下午了...
>
> 那時候是覺得如果要辦這樣的活動，事先的準備中�@定要先定位出問題程式碼在哪
> 裡，所以這也是我現在做 CSS2.1 實�@註解[3]的�@個目標（不過我不能保證我會
> 不會定位出問題就手癢送補丁了 :p）
>
> [3] http://www.w3.org/html/ig/zh/wiki/CSS2/impl
>
> == 如何參與？==
>
> 我們採 wiki 自助式：
>
> 1. 上W3C註冊帳號頁[4]註冊帳號、記得不要用中文（抱歉、W3C的系統不是很有國
> 際觀）
> 2. 找想翻譯的段落、看看[5]的對照表有沒有重復
> 3. 開始翻譯！有wiki的問題歡迎私下問或是在列表或是討論頁詢問
>
> 如果想要註解的實�@部份尚未有中文翻譯，也歡迎自己先找個地方做英文版規範的
> 實�@註解，之後在統合�@下。
>
> 就像上面講得，如果有商業公司有未來�@意開發 WebKit 哪個部份的情報可以先告
> 知�@下的話，我們可以先看那個部份的程式碼。
>
> 其他交流管道：
> * W3C HTML5 中文興趣小組郵件群[6]
> * irc.mozilla.org #mozilla-taiwan（我是 MozTW 社群成員，但是本專案與
> Mozilla Taiwan 無關）
> * QQ HTML5 翻譯群，群號：151145242
> * 私信
>
> [4] http://www.w3.org/Help/Account/Request/Public
> [5]
>
> http://www.w3.org/html/ig/zh/wiki/Talk:HTML5/impl#.E8.B2.A2.E7.8D.BB.E6.8F.90.E5.A0.B1
>
>
>
> 呂 康豪（Kenny）, 中文興趣小組W3C連絡人, Amateur Gecko/WebKit Contributor
> Google+: https://plus.google.com/112088462407783855918/posts
> 新浪微博: http://t.sina.com.cn/1950042164
>
> ----------信件結束----------
>
>
> 合�@愉快！
>
> Kenny
>



-- 
Po-chiang Chao  (:BobChao)
Mozillian and Creative Commoner, Taiwan
http://twitter.com/bobchao <http://blog.bobchao.net/>

Received on Wednesday, 16 November 2011 08:24:20 UTC