免費AI編程助手
PyPDF2 項目治理
本文檔描述了如何管理 PyPDF2 項目。它描述了不同的參與者、他們的角色以及他們的責任。
術語
該項目是 PyPDF2——一個免費開源的純 Python PDF 庫，能夠拆分、合并、裁剪和轉(zhuǎn)換 PDF 文件的頁面。它包括GitHub 上的代碼、問題和討論，以及ReadTheDocs 上的文檔、 PyPI 上的包和 GitHub 上的網(wǎng)站。
維護者是擁有更改項目的一個或多個部分的技術許可的人。這是一個被驅(qū)動來保持項目運行和改進的人。
貢獻者是為項目做出貢獻的人。這可以通過編寫代碼來實現(xiàn)——最好的情況是通過分叉和創(chuàng)建拉取請求，但這取決于維護者。其他貢獻者描述問題，幫助就現(xiàn)有問題提出問題，使它們更容易回答，參與討論，并幫助改進文檔。貢獻者類似于維護者，但沒有技術許可。
用戶是將 PyPDF2 導入到他們的代碼中的人。所有 PyPDF2 用戶都是開發(fā)人員，但不是了解 PyPDF2 內(nèi)部結構的開發(fā)人員。他們只使用 PyPDF2 的公共接口。他們可能比貢獻者對 PDF 的了解更少。
社區(qū)就是這一切——用戶、貢獻者和維護者。
治理、領導和指導 PyPDF2 向前發(fā)展
PyPDF2 是一個免費的開源項目，擁有超過 100 名貢獻者和可能（方式）超過 1000 名用戶。
由于 PyPDF2 與任何公司沒有任何正式關系，也沒有任何資助，因此社區(qū)所做的所有工作都是自愿貢獻的。人們沒有得到報酬，而是選擇利用空閑時間來創(chuàng)建軟件，讓更多人從中獲利。這必須得到尊重和尊重。
盡管有如此龐大的社區(qū)，該項目從 2016 年到 2022 年一直處于休眠狀態(tài)。仍有問題被提出，問題被報告，并且請求請求被創(chuàng)建。但是維護者沒有時間推動 PyPDF2 向前發(fā)展。在那段時間里，沒有其他人站出來成為新的維護者。
出于這個原因，PyPDF2 具有Benevolent Dictator 治理模型。仁慈的獨裁者是擁有所有技術權限的維護者——最重要的是在 PyPI 上推送新 PyPDF2 版本的權限。
作為仁慈的，仁慈的獨裁者傾聽社區(qū)的決定，并盡最大努力做出使整個社區(qū)受益的決定——當前的和潛在的未來。作為一個獨裁者，仁慈的獨裁者總是有權力和權利自己做出決定——也可以針對社區(qū)的某些成員。
由于 PyPDF2 是免費軟件，部分社區(qū)可以拆分（分叉代碼）并創(chuàng)建一個新社區(qū)。這應該會限制一個壞仁慈的獨裁者可能造成的傷害。
項目語言
項目語言為（美式）英語。所有文檔和問題都必須用英文書寫，以確保社區(qū)能夠理解。
我們理解社區(qū)中大部分人的母語不是英語。我們盡力理解他人 - 自動翻譯器可能會有所幫助。
期望
社區(qū)可以期待以下內(nèi)容：
仁慈的獨裁者盡最大努力做出使整個社區(qū)受益的決定。仁慈的獨裁者知道他/她的決定可以影響整個社區(qū)。一旦仁慈的獨裁者注意到她/他沒有時間推進 PyPDF2，他/她就會尋找新的仁慈的獨裁者。由于預計仁慈的獨裁者將在他們選擇的某個時間點（希望在他們死前）下臺，因此它不是終身仁慈的獨裁者（BDFL）。
每個維護者（包括仁慈的獨裁者）都知道他們的權限和他們可能造成的傷害。他們重視安全并確保項目不受損害。如果他們不再需要他們，他們會退還他們的技術許可。任何長期貢獻者都可以成為維護者。維護者可以——而且應該！- 當他們意識到他們不能再承諾那個時間時，就辭去他們的角色。他們的貢獻將載入 PyPDF2 的歷史。
每個貢獻者都知道維護者和仁慈的獨裁者的時間是有限的。簡短描述已解決問題并進行單元測試的簡短拉取請求更有可能很快被合并——僅僅是因為維護者更容易看到貢獻不會損害整個項目。他們的貢獻記錄在 git 歷史和公共問題中。讓我們知道 您是否會喜歡其他東西！
每個社區(qū)成員都使用尊重的語言。我們都是人，我們會對我們關心的事情和我們生活中發(fā)生的互聯(lián)網(wǎng)上可見的事情感到不安。PyPDF2 不支付其貢獻者 - 當您與他人互動時請記住所有這些。我們在這里是因為我們想幫助別人。
問題和討論
一個問題是任何旨在推動 PyPDF2 發(fā)展的技術描述：
錯誤票：因為 PyPDF2 開發(fā)人員犯了一個錯誤，所以出了點問題。
功能請求：PyPDF2 不支持 PDF 規(guī)范的所有功能。當然還有一些方便的方法可以幫助用戶很多。
穩(wěn)健性要求：周圍有許多損壞的 PDF。在某些情況下，我們可以處理。它是錯誤通知單和功能請求之間的一種混合體。
性能票：PyPDF2 可能會更快 - 讓我們知道您的具體情況。
那些對討論沒有幫助的技術描述中的任何評論都可以刪除。對于錯誤的“我也是”評論或?qū)λ韫δ艿摹鞍纪埂痹u論尤其如此。人們可以用 ?? / ?? 反應來表達這一點。
討論是開放的。那里不會刪除任何評論 - 除非它們是明顯無關的垃圾郵件或只是試圖侮辱別人（幸運的是，到目前為止社區(qū)非常尊重 ??）
發(fā)布
維護者遵循語義版本控制。最重要的是，這意味著重大更改將有一個主要版本。
請注意，仍然可能會發(fā)生無意的破壞性更改。PyPDF2 維護者會盡最大努力及時修復該問題 - 請 報告此類問題！
人們
馬丁托馬自 2022 年 4 月起成為仁慈的獨裁者。
維護者：
Matthew Stamy (mstamy2) 長期以來一直是仁慈的獨裁者。他仍然偶爾會在 GitHub 上轉(zhuǎn)轉(zhuǎn)，并且擁有 PyPI 和 GitHub 的權限。
Matthew Peveler (MasterOdin) 是 GitHub 上的維護者。
更多建議：