貢獻指南

狀態：公開草案

版本：0.1.0

更新日：2026-08-21

感謝你願意協助平台。小型來源更正、替代文字、文件錯字與測試回報，和完整功能同樣重要。第一次參與不需要先熟悉所有程式或治理規則。

參與前先確認

遵守社群行為準則。
不在公開議題放入私人聯絡方式、身分證明、採購名單、密鑰或安全弱點細節。
只提供你有權提供的文字、程式、資料與圖片。
揭露你與受影響單位、資助者、供應商、雇主或有薪工作的利益關係。
了解貢獻被採用不等於聘用、報酬、背書、治理席位或商品排序權。
了解目前整體授權尚未選定；提交前請閱讀權利與再利用。

可以貢獻什麼

資料

新增或修正單位、商品、服務、價格、地區、分類、圖片與來源。請依資料治理提供欄位級證據。

文件與內容

修正不清楚的句子、補充使用說明、降低術語、增加文件間連結、翻譯或提供易讀版本。不要把尚未存在的預算、職缺、合作、處理時限或功能寫成事實。

無障礙與設計

回報鍵盤、焦點、語意、替代文字、對比、縮放、動畫與表單問題。最好提供裝置、瀏覽器、輔具、重現步驟與期望結果，但不要求揭露障礙或健康資訊。

程式與測試

修正錯誤、改善測試、效能、安全與可維護性。重大功能先提出可討論的問題與資料處理影響，避免完成大量工作後才發現方向不符。

研究與社群

協助訪談規劃、服務藍圖、治理回饋與新手引導。未經明確同意，不錄音、不發布逐字稿，也不把研究參與包裝成單位背書。

建議工作流程

搜尋是否已有相同議題或提案。
小型、可直接驗證的修正可直接提出；較大變更先說明問題、使用者與替代方案。
從最新主分支建立範圍單一的變更。
只修改該提案必要的檔案，保留其他人的工作。
執行與風險相稱的檢查，並在提案中寫下已測與未測部分。
回應審閱時聚焦證據與影響；可以不同意，也可以停止或撤回提案。
合併後若發現問題，提出回復或更正，不隱藏錯誤。

提案內容範本

問題：目前誰遇到什麼困難？
變更：本次改了什麼？刻意沒有改什麼？
依據：來源、測試或使用者回饋是什麼？
風險：隱私、安全、無障礙、內容權利與資料正確性影響？
利益衝突：我與受影響單位、資助或有薪工作有何關係？
驗證：完成哪些檢查？哪些尚未檢查？
回復：如果效果不好，要如何撤回？

資料提案最低內容

穩定 ID 或可辨識的頁面位置。
建議欄位與修改前／後內容。
能直接支持主張的原單位或政府來源。
查核日期；價格需說明規格或限制。
圖片來源及你是否有權提供檔案。
若要求下架，說明風險；不必在公開區貼出敏感證明。

品質檢查

依變更類型確認：

162 間政府名冊資料與 50 間企業選品未被示範資料覆蓋或意外刪除。
每間全台名錄資料仍保留代表商品或服務、相符圖片與政府登記來源；社群及官網缺項不以推測補值。
來源、圖片與外部連結仍指向對應內容。
搜尋、篩選、收藏與主要導流行動語意一致。
鍵盤操作、焦點、標題層級、表單標籤與對比可用。
沒有新增不必要的個資、追蹤、密鑰或第三方傳輸。
文件陳述與實際功能一致。
自動檢查與正式建置通過；未能執行的部分清楚揭露。

審閱與合併

審閱者可要求證據、測試、拆分或風險處理。涉及審閱者本人、雇主、客戶、資助者或密切關係人的變更，審閱者應揭露並退出最終決定。贊助、有薪身分或長期貢獻不能跳過查核。

如果人力不足導致只能由一人審閱，應在變更紀錄中說明限制；高風險、不可逆或利益衝突案件應等待獨立審閱，不用形式上的快速合併掩蓋風險。

有薪與無薪邊界

公開貢獻是自願的，可拒絕、停止或退出，不需無薪待命。平台不以「先做一版看看」要求求職者或潛在承攬者提供無薪試作。有薪機會只有在經費、範圍、報酬、契約與適當法律關係完成確認後才成立；登記人才庫不是錄用承諾。

自願貢獻不得取代持續、必要、受指揮管理的核心營運。若一項工作需要固定時段、密集管理、即時責任或長期維護，應先尋找資源與有薪安排。

授權與權利

目前專案尚未選定整體程式碼與文件授權。不得因儲存庫或文件公開，就推定可以複製、修改、散布或商用。合併外部貢獻前，維護者須確認適用授權或取得明確同意；第三方圖片、商標及來源內容仍受原權利人條件約束。詳見權利與再利用。

安全與隱私回報

安全弱點不要發在公開議題；依安全政策私下回報。個資或隱私風險依隱私說明提出。一般資料錯誤可以公開，但如證據包含個資，先描述問題並詢問安全提交方式。