注意: 雖然 JavaScript 對於本網站不是必不可少的,但您與內容的互動將受到限制。請開啟 JavaScript 以獲得完整體驗。

Python 特殊興趣小組 - 指南

Python SIG 建立指南

建立新 SIG 的指南相當非正式,但有一些關鍵事項是必要的。首先,我們概述 SIG 的一般框架,然後描述如果您希望我們建立一個新的 SIG,您必須做什麼。

SIG 郵件列表由 GNU Mailman 管理,這是一個用 Python 編寫的基於 Web 的郵件列表介面。訂閱/取消訂閱請求、訊息存檔等都自動發生,無需人工干預。這是一件好事 (TM),因為此類響應應該被非常快速地處理。(雖然與郵件列表互動的通常方式是透過 SIG 的“listinfo”網頁,但也可以將命令傳送到特殊的管理地址,請參見下文。)

每個 SIG 都必須有一個明確的任務,具有明確的結論和結束日期,以及一名協調員 - 負責報告 SIG 活動並指導 SIG 活動和總結的具體人員。如果活動有必要,可以延長結束日期,但我們需要一些合理的總結目標,以避免維護無效率的 SIG。

要建立 SIG,一旦您滿足這些標準,請在 meta-sig 郵件列表上提出討論。如果您獲得關於 SIG 值得建立的同意 - 尤其是在沒有其他 SIG 或一般的 Python 新聞組更合適的情況下 - 並且您的協調員已準備就緒,則將建立 SIG。

郵件列表框架

每個郵件列表都有一個短名稱,例如“gui”。對於每個 SIG,都有三個特殊地址

  • <名稱>-sig@python.org:用於向 SIG 郵件列表釋出訊息的地址。傳送到此地址的任何內容都會轉發給所有列表成員,並且還會自動存檔。請小心您傳送到此地址的內容!
  • <名稱>-sig-request@python.org:這是一個電子郵件機器人地址,可以處理訂閱和刪除請求、幫助請求和其他 Mailman 電子郵件命令。通常,這些訊息不會被人類看到或處理。如需更多幫助,請將帶有單詞help的訊息傳送到此地址主題標頭。
  • <名稱>-sig-owner@python.org:這是一個別名,可以聯絡到 SIG 郵件列表的管理員。這將是管理郵件列表具體事項的人員,例如訂閱/取消訂閱批准(如果需要)、批准保留的帖子等。此地址的另一端始終是一個真人,因此如果您需要聯絡真人,這是要使用的地址。

郵件列表策略

每個郵件列表都有一個策略,用於確定誰可以加入列表或釋出訊息等。通常,所有 SIG 列表都具有以下(相當寬鬆的)策略。SIG 所有者擁有自己的 Mailman Web 介面,因此他們可以在沒有我們幫助的情況下更改策略。

  • 訂閱對所有人開放。僅當訂閱地址與訂閱訊息的郵件標頭不匹配時,才需要批准。
  • 任何人都可以向列表釋出訊息,即使他們不是列表的成員。該列表不會被稽核。

建立指南

所以你想建立一個新的 SIG 郵件列表?那麼這就是你必須做的。最重要的是,你必須對你的列表負責。這意味著我們必須將 <名稱>-sig-owner@python.org 別名為你的個人郵箱:-)。你不會經常被騷擾(希望如此),但你可能偶爾需要處理訂閱批准,並且每當有人訂閱或取消訂閱時,你都會收到可忽略的通知訊息。你最重要的工作可能是在郵件列表中丟棄被 Mailman 正確保留的垃圾郵件。

你應該決定你的主題是什麼,以及它的範圍是什麼。儘量保持專注,並確保你驗證沒有其他 SIG 涵蓋你的主題。你需要寫兩件事。首先,你應該寫一個關於你的 SIG 的簡簡訊息摘要;只是可以放在 SIG 短列表中的內容,例如“C++ 繫結的開發”。

你還需要寫一個稍微長一點的摘要,該摘要最終將用在 SIG 的網頁上。例如,這是 meta SIG 的資訊頁面。包含你認為必要的儘可能多的資訊,但儘量保持相當簡短和簡潔。

你應在 meta SIG 郵件列表上討論你提議的 SIG。介紹你的提案,幷包括兩個摘要的草稿,以便我們可以討論新 SIG 的優點。如果達成共識要建立它,我們將建立必要的基礎設施並與你溝通有關細節。