# 貢獻指南

> 狀態：公開草案
>
> 版本：0.1.0
>
> 更新日：2026-08-21

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

## 參與前先確認

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

## 可以貢獻什麼

### 資料

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

### 文件與內容

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

### 無障礙與設計

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

### 程式與測試

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

### 研究與社群

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

## 建議工作流程

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

## 提案內容範本

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

## 資料提案最低內容

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

## 品質檢查

依變更類型確認：

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

## 審閱與合併

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

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

## 有薪與無薪邊界

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

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

## 授權與權利

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

## 安全與隱私回報

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

## 參考依據

- [GitHub Docs：About community profiles for public repositories](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/about-community-profiles-for-public-repositories)
- [Open Source Guides：How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)
- [Contributor Covenant 3.0](https://www.contributor-covenant.org/version/3/0/code_of_conduct/)
- [勞動部：勞動契約如何認定](https://www.mol.gov.tw/1607/28162/28296/28340/28342/28344/lpsimplelist)