iT邦幫忙

第 11 屆 iThome 鐵人賽

DAY 24
0
Software Development

模組化設計系列 第 24

Day24 - 模組的 README 設計

  • 分享至 

  • xImage
  •  

README 是模組的門面,能不能吸引要別人使用你的模組,就看這一頁了。

slogan

通常第一行都是口號 (slogan),用一句最吸睛的話,來介紹你的模組。

badges

口號後面通常接著徽章 (badges),讓使用者可以一目瞭然知道模組目前的狀態。

Build

  • Travis
  • 建構的狀態

Code Coverage

  • codecov
  • 測試涵蓋率

Dependencies

  • Dependency Status
  • 相依的外部模組狀態

Downloads

  • npm downloads
  • 模組下載次數

License

  • 授權的類型

Version

  • 版本

Intro

通常包括

  • Installation and Usage
  • how to start?
  • Feature 列表

Test

說明怎麼執行測試程式

npm test

Maintainers

主要維護者資訊

[alincode](https://github.com/alincode) - **AILIN LIOU** (author)

License

授權的類型

MIT © [alincode](https://github.com/alincode)

好用工具

可以自動產生 README 格式

https://www.npmjs.com/package/readme-md-generator

延伸閱讀


上一篇
Day23 - 模組目錄結構設計
下一篇
Day25 - 一個好的模組應該要提供的其他資訊
系列文
模組化設計30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言