[你也可以檢視這份文件的 單頁版本。]
以下建議是根據多年來 Subversion 郵件列表的經驗,並針對這些列表上最常出現的問題提出說明。請勿將其視為郵件列表禮儀的完整指南 —如果你想要,你可以在網路上很輕易地 找到其中一個。
如果你在張貼到我們的郵件列表時遵循這些慣例,你的貼文更有可能被閱讀和回覆。
如有疑問,請寄信至 users@subversion.apache.org,而非 dev@subversion.apache.org。users@ 清單中有許多經驗豐富的人員(包括一些 Subversion 維護人員)— 他們或許可以回答您的問題,或者如果您認為您已發現錯誤,他們可以判斷這是否為真正的錯誤。當您想要建議新功能時,您甚至應該張貼至 users@:許多功能建議都是之前討論過的想法,而 users@subversion.apache.org 郵件清單上的某人通常可以判斷您的建議是否屬於此類。
請不要在未從 users@ 取得答案後,將 dev@ 作為最後的手段。這兩個清單有不同的章程:users@ 是支援論壇,dev@ 是開發討論清單。當支援問題在 users@ 上未獲得解答時,這很不幸,但這並不會讓問題適合在 dev@ 上提出。
當然,如果郵件是關於 Subversion 中可能的錯誤,且在 users@ 上沒有得到任何反應,那麼在 dev@ 上詢問是沒問題的— 錯誤是開發主題。而且 修補程式 應始終直接傳送至 dev@。
有時,當對某個主題感到非常熱情時,會忍不住回應郵件串中的每則訊息。請不要這麼做。我們的郵件清單流量已經很高,而追蹤每一則訊息只會增加雜訊。
相反地,請閱讀整個郵件串,仔細思考您想說什麼,選擇一則訊息來回覆,然後闡述您的想法。偶爾在串中回覆兩則不同的訊息可能是合理的,但僅限於主題開始分歧時。
請勿使用超過 72 個欄位的行。許多人使用 80 個欄位的終端機來閱讀電子郵件。透過將文字寫在 72 個欄位中,您可預留空間,以便在日後回覆時加入引號字元,而不會強制換行文字。當然,72 個欄位的限制僅適用於訊息的散文部分。如果您要張貼程式碼修補程式,請參閱程式碼修補程式區段。
有些郵件程式會自動換行,因此當您撰寫郵件時,顯示器會顯示實際上不存在的換行符號。當郵件傳送至清單時,它不會有您認為有的換行符號。如果您的郵件編輯器會這樣做,請尋找可以調整的設定,以顯示真正的換行符號。
將每個句子的第一個字母大寫,並使用段落。如果您要顯示螢幕輸出或其他類型的範例,請將其設為明顯與散文分開的區塊。如果您沒有執行這些動作,您的郵件將會比它可能有的樣子難讀許多,而且許多人根本不會費心閱讀它。
回覆清單文章時,請務必使用您的郵件閱讀器的「追蹤」、「回覆所有人」或「群組回覆」功能。否則,您的郵件將只會傳送給原始文章的作者,而不是整個清單。除非有理由私下回覆,否則最好總是回覆清單,讓所有人都能觀看和學習。(此外,許多經常收到文章私人回覆的人表示,他們希望這些回覆改為傳送至清單。)
請注意,Subversion 郵件清單不會修改 回覆至 標頭,以將回應重新導向至清單。他們會將 回覆至 設為原始寄件者的設定,原因列於 https://www.unicom.com/pw/reply-to-harmful.html,特別是「最小損害原則」和「找不到回家的路」部分。偶爾會有人發文詢問我們為何不設定 回覆至 標頭。有時,那個人會提到 https://marc.merlins.org/netrants/reply-to-useful.html,其中提出修改 回覆至 欄位的論點。清單管理員知道這兩份文件,並且認為論點的雙方都有其優點,但最後選擇不修改 回覆至 標頭。請不要再重提這個話題。
不要透過回覆現有文章來開始新的主題串 (主旨)。相反地,請開始撰寫新郵件,即使這表示您必須手動寫出清單地址。如果您回覆現有文章,您的郵件閱讀器可能會包含將您的文章標記為該主題串中後續文章的元資料。變更 主旨 標頭不足以防止這種情況!許多郵件閱讀器仍會保留足夠的元資料,將您的文章放入錯誤的主題串中。如果發生這種情況,不僅有些人看不到您的文章 (因為他們忽略該主題串),而且正在閱讀該主題串的人會浪費時間在您的離題文章上。避免這種情況最安全的方法是,永遠不要使用「回覆」來開始新主題。
(問題的根源在於,有些郵件介面並未指出「回覆」功能所產生的訊息與全新訊息之間的差異。如果您使用此類程式,請考慮向其開發人員提交增強要求或補丁程式,以使其顯示區別。)
如果您確實需要在保留串聯的同時變更 主旨 標頭(可能是因為串聯已轉移到其他主題),請在新的主旨下發布一則貼文,並在括號中加上舊的主旨,如下所示
Blue asparagus | |_ Re: Blue asparagus | |_ Yellow elephants (was: Re: Blue asparagus) <-- ### switch ### | |_ Re: Yellow elephants
請不要反射性地斥責人們頂部發文。「頂部發文」是指將回應文字置於引文文字上方,而不是與其交錯或置於其下方。通常,引文文字會提供理解回應的重要背景,因此頂部發文會造成阻礙。有時,人們會在應交錯發文或底部發文時頂部發文,而其他人則會因此斥責他們。如果您必須斥責,請溫和地進行,而且絕對不要費心額外發一則貼文,只為了指出像這樣的次要問題。甚至在某些情況下,頂部發文是較佳的選擇,例如,當回應簡短且一般,且適用於長篇引文文字的整體時。因此,頂部發文總是需要判斷,而且即使在不適當的情況下進行,它也不是什麼大不便。
如果您是來這裡尋找如何引用的建議,而不是如何不因人們的糟糕引用習慣而批評他們,請參閱 https://www.netmeister.org/news/learn2quote.html(德語:http://www.afaik.de/usenet/faq/zitieren/download/zitieren-alles.html)。
請參閱此處,以取得如何傳送修補程式的建議。請注意,你可以傳送修補程式來修改這些網頁以及修改程式碼;網頁的儲存庫 URL 為https://svn.apache.org/repos/asf/subversion/site/。
如果可能,請使用 ASCII 或 ISO-8859 文字。請勿張貼 HTML 郵件、RTF 郵件或其他可能對純文字郵件閱讀器不透明的格式。關於語言:我們沒有僅限英語的政策,但如果你以英語張貼,你可能會獲得最佳結果,因為這是參與名單人數最多的語言。