# Building popular open source projects - Yo-An Lin (c9s)

{%hackmd tGp8pt49Q2aT5cD5TFyaIA %}

> 請從這裡開始

## 有需要讓你的 Projects 變熱門嗎？
**Yes!**

群聚效應

## 如何參與開源

~要有女朋友~

- 4P
- 4C

- 不要無腦的開始做 Project，要考慮市場潛力、獨特性、爭議性
- 有相同的東西就做得更好吧

## 怎麼樣讓大家更容易記住？

- 專案名稱
- 若拿 Porpose 當 Project name，Google 搜尋的結果就很難找到
- 要少於 3 個字
- 要可以好發音（Pronounceable）
- 要有獨特性
- 組合單字、創造新字
- 第一印象
- SYNOPSIS
- CPAN
- 要有 Workable Example
- 試吃
- 友善授權 (License)
- 簡易使用 (Easy to use)
- 設定到使用 (Setup to Use) 非常重要
- 減少挫折感
- = 幫使用者快速建立環境
- 多環境設置測試, e.g. Travis CI
- For Contributors
- 要有簡易有效的開發環境建置步驟
- 使用良好的套件工具避免 Dependency Failure
- Debugging
- 要有 Troble Shooting Guide
- 避免常見錯誤，解決挫折感、失落感
- GitHub Wiki
- 詳細確實 (Details)
- 多數開發者還是依賴開發文件
- 完整度
- 增加使用意願
- 完整度的表現
- 平台支援度
- 細節的 Coverage
- ~可以製造安全感的假象~
- 善用媒體
- 在 Stackoverflow 回答時順便 Promote
- 各種媒體
- Mailing List
- Google Group
- IRC
- Twitter
- Facebook
- Hacker News
- [Show HN](https://news.ycombinator.com/show)
- 善用 Mail Signature
- 多管閒事
- (剛才說的 Stackoverflow)
- 打鐵趁熱
- 對於 PR、Issues 要趕快回覆，避免流失 Contributors
- Merged pull request makes people happy
- 若可以的話儘量不要 reject PR
- = 儘量不要發好人卡
- 可以先收下 PR 再來改
- 在 readme file 上加點 Contribution Guide
- 步步高陞
- 版本號不用錢
- 不用擔心版本號跳太快
- [SemVer](https://semver.org/)
- 儘可能縮小釋出版
- 縮短釋出時程 (Relase Fast)
- 讓被合併的功能儘快在新版本釋出並使用
- 正向循環
- Be kind to others
- Respect to each others
- No RTFM
- 彼此勉勵
- 列出貢獻者
- "If you build it, they will come" - Field of Dreams

###### tags: `COSCUP2018` `oss`