How to Write a README on GitHub

最近在寫 GitHub 上的 README,發現這個東西好像每個人的寫法都不太一樣,於是稍微整理了一下自己覺得大概要包含哪些內容。 Motivation 顧名思義就是簡介一下為什麼會有這個專案,以及這個專案大概在做什麼,解決了什麼問題。最好是三到五句話講出重點,不然很多人看到落落長的文章可能就跳過了 XD Getting Started / Installation 如何快速地開始使用這個專案,通常會包含安裝以及環境設定等等。 Example / Demo 一個簡單有力的範例可以讓大家更容易了解這個專案在做什麼,也有人會將這段與 Getting Started 整合在一起。基本上我在 »