Arch Linux 行為準則 管理著所有 Arch 項目。
ArchWiki 致力於成為一個清晰、全面、專業的文檔。為了達到這一目的,我們將工作劃分為不同的任務。本文主要介紹你可以幫助完善 ArchWiki 的主要任務。
這是一個來自社區、服務社區的工作。如果想更進一步,可以申請成為wiki 維護者。
三個基本原則
有三個基本的原則需要貢獻者遵守,不管您是新手還是老用戶。這是對其它用戶的尊重:
每個 Wiki 貢獻者都必須明白,你的編輯早晚會被其它用戶檢查和編輯,遵循此建議可以方便其它用戶理解您的編輯。若你參加過軟體合作項目,應能理解維基編輯摘要和git提交說明(commit message)、維基編輯差異和git diff的相似性。
總是正確使用編輯摘要
編輯摘要(或稱變更摘要)是編輯頁面的編輯區域下方、保存按鈕上方的文本框。每次編輯,都需要有充足且簡潔的信息說明「做了什麼」和「為什麼」。內部連結在編輯摘要中也生效,可以連結到相關的討論或文章;也可以貼上連結到編輯差異、或是外部的論壇帖子或者郵件列表的URL。
只有當編輯是小編輯(小改動),例如語法或詞句的修改時,可以忽略「為什麼」。類似地,向討論頁面中加入內容或回復已有內容,並不需要重複討論信息。
/* 章節標題 */
。這不是一段注釋,/*
和*/
之間的文本將被轉換為到該節的連結。請在其後填寫編輯摘要。- 查看近期變更中的摘要可以學習其他人是如何做的,但是請注意並不是所有人都遵循這些準則。
- 使用類似Special:Diff/359881/next的連結以生成可點擊的差異對比連結,詳細語法可參考MediaWiki的說明.
不要一次進行大量的改動
執行大的改動時,無論是對條目還是討論頁,最好將其分到多個編輯操作中,比如可根據邏輯步驟一步一步完成。如果有疑問,通過「顯示差異」按鈕查看diff,看看其它用戶能否理解您的編輯變化。例舉一些會造成令人困惑的差異的操作:
- 移動段落的同時編輯了內容。解決方法:移動段落,保存,再次打開進行編輯。
- 在同一個編輯中改變多個段落的順序。解決方法:一次僅移動一個段落。
進行頁面重排前進行討論
如果您要大規模的修改文章結構或者重寫段落,請在討論頁面提前通知,並解釋目的和方式。等待一段時間以便其它用戶有時間回復和提出自己的看法。
注意,即使經過提前的討論,仍然需要注意#總是正確使用編輯摘要和#不要一次進行大量的改動。
最重要的任務
接下來,本文將介紹多種可為本維基做貢獻的方式。其中最重要的一點是:將您最感興趣的頁面添加到監視列表,並保護它們不受低質量編輯的影響。
ArchWiki 每天都收到來自許多不同用戶的大量編輯修改。大部分修改都是實際上的改進,但是一個不小心的修改(哪怕經常出自善意)就可能產生不良後果,包括不準確的信息和內容丟失。如果沒有人注意,就會毀掉你和其他用戶之前貢獻的寶貴內容。這樣的編輯其實很容易發生,頻率也許超出你的想像,所以 Wiki 維護者和管理員花費了大量時間對這類低質量編輯進行修復。但是您不能完全依賴管理員,因為他們和你一樣,能夠花在 wiki 中的時間也是有限的,而且您對某些特定領域的了解還會比管理員更專業。所以如果用戶只專注於添加新內容,而不注重保護已有內容,您的貢獻可能會被破壞,維基也不可能正常工作。
幸運的是,wiki 提供了有用的功能避免此類事情的發生。只需要點擊頁面頂部的監視連結,就可以將頁面加入你的編輯監視列表。這樣就可以在監視列表查看改動,或在參數設置頁面的電子郵件選項下選擇在監視頁面發生變動時收到電郵通知。在近期變更頁面,監視的頁面會被高亮顯示。最後,可以在監視首選項中修改設置,包括自動將修改過的頁面加入監視列表。
如果發現監視頁面的改動有問題,或者不明白為什麼被編輯,建議立即修正它,或在相應條目的討論頁面、或編輯作者的討論頁面詢問。
參考資料
做貢獻前,需要了解的內容:
- 命名規範討論有效的文章命名策略和原因,以確保它們的可讀性和可檢索性。創建頁面前請先閱讀此文。
- 編輯幫助是一個簡短的 ArchWiki 編輯指南。描述了 MediaWiki 的格式語法和 ArchWiki 的相關規範。是 ArchWiki 貢獻者的必讀文章。
- 討論幫助頁面說明如何通過討論頁面與其他人交流。
- 文章樣式規範提供了一個 ArchWiki 使用的標準風格指導。
- 頁面分類介紹如何設置頁面分類,創建缺失的分類,如何將頁面移動到另外的分類。
- ArchWiki Translation Team (簡體中文)有一個創建新翻譯的詳細步驟,翻譯文章時請按照此步驟進行。
- Help:i18n (簡體中文)是 ArchWiki 國際化和本地化的全面指引。
- Help:Procedures (簡體中文)介紹了一些常用的編輯動作。
幫助分類包含了所有的幫助頁面。
創建
先確保你已經理解了 ArchWiki 的哲學並考慮別人想讀什麼(參見需求)。正如前面所說,wiki 的範圍很廣。
請聯繫管理員獲得主要項目的協調幫助。
創建頁面包含在主命名空間創建頁面的步驟。
Wiki 的子頁面功能同樣可用於你的用戶頁。可用於創建空白頁面的草稿。注意用戶頁面不能分類,但其他特性均可用。草稿完成之後,簡單地將子頁面移動到新的名稱下即可。請在移動後再添加條目的相關狀態模板。狀態模板的理由描述越詳盡,就越方便維護維基的用戶與你合作。
完善
在任何 Wiki 中,內容編輯、完善和更新都是永不停息的持續過程。如果希望提供幫助,請註冊一個用戶並開始進行:
非 Arch 用戶
任何人都可以註冊一個用戶。歡迎非 Arch 用戶貢獻適用於其他 Linux 發行版或其他作業系統的內容,只要能確定它同樣適用於 Arch Linux。需要指出,條目是為 Arch 用戶編寫的,因此:
- 不要添加僅僅與其他 Linux 發行版或者作業系統相關的內容。例如,Fedora 用戶同樣可以為 systemd (簡體中文)的頁面貢獻,但若提及新內容在 Fedora 上工作,後者將視為無關內容而被刪除。
- 不要將 Arch 專有的約定、術語或工具替換為適用於更大範圍作業系統的版本。
維護
- 巡查近期變更, 報告和修正有問題的編輯.
- 為頁面打上適當的頁面狀態模板,例如: 刪除
{{Remove}}
, 過期{{Out of date}}
, 待翻譯{{Translateme}}
,不準確{{Accuracy}}
,歸檔{{Archive}}
。 - 將一些頁面加入你的監視列表,以防止文章被低質量更改破壞。這是#最重要的任務。
- 參加討論頁面中的討論:大部分用戶可以通過此連結查看討論頁的最新更改。和維護直接相關的討論位於[1], [2], [3] 和 [4]; 此外 ArchWiki:Requests 也是一個討論頁面。
組織
整理、歸類和移動頁面是所有 Wiki 維護者的主要任務。
翻譯
簡體中文維基是外部 wiki 站點。我們歡迎您幫助翻譯 ArchWiki 的其他語種頁面到本 wiki 以豐富其內容,但要注意一一對應的翻譯不是必須的。請閱讀幫助:翻譯以開始翻譯。
關於 Arch Linux 官方 wiki 的翻譯團隊,請參見 arch:ArchWiki:Contributing#Translating。
頭腦風暴
為了同其他用戶實時協調貢獻,可以使用 Arch Linux 官方專用的 #archlinux-wiki IRC 頻道。而對於 Arch Linux 中文維基,則可以使用 Telegram 或者 Matrix 群天群組。
如果不確定從哪裡開始,或者覺得編輯別人的文章很彆扭,你也可以在 Arch Linux 論壇、論壇和 Wiki 討論和中文論壇中提出主意和建議。
後台維護
使用 Arch Linux Bugtracker 貢獻修復並完善 MediaWiki 代碼。可參閱關於 ArchWiki 後端的已報告的 bug 列表。
抱怨
是的,只要表達方式合理,即使是普通的抱怨我們也接受,這也是提高 Wiki 的一種方式。有抱怨,請前往 ArchWiki talk:Administrators 頁面。當然,應該不用特別說明,請儘可能用文明的和尊重的語氣來抱怨一些事 :)
抱怨或評論的所有合適的位置和方法都在頁面 ArchWiki:維護團隊#使用什麼方式聯繫到責任人中被概述。