《Koa誕生記》——如何寫好README

回顧前三章內(nèi)容籍琳,討論了koa的核心模塊 koa-compose的實(shí)現(xiàn)话侧,自己實(shí)現(xiàn)一個(gè)簡(jiǎn)單的koa馆蠕,以及koa實(shí)現(xiàn) status code反向映射的操作涝桅。那對(duì)于一個(gè)開源項(xiàng)目還缺少什么呢?至少還缺少以下幾個(gè)方面:

  • 完整的測(cè)試用例
  • 標(biāo)準(zhǔn)的API文檔
  • 代碼執(zhí)行效率分析
  • README

從README開始

如果你想讓別人盡快的了解你的項(xiàng)目峻汉,就需要想盡辦法在README上下些功夫贴汪。

一個(gè)好的 README需要告訴其他可能的協(xié)作者:

  • 項(xiàng)目的作用及解決的問題
  • 如何開始項(xiàng)目
  • 如何編譯、安裝休吠、運(yùn)行
  • 貢獻(xiàn)者
  • 許可

標(biāo)準(zhǔn)示例

readme示例

當(dāng)然扳埂,使用更加漂亮的圖標(biāo)和banner,更加容易將項(xiàng)目進(jìn)行推廣蛛碌。

koa的README

在第一版本中聂喇,koa的readme是這樣的:

素材&應(yīng)用

從零開始寫README

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子希太,更是在濱河造成了極大的恐慌克饶,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,265評(píng)論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件誊辉,死亡現(xiàn)場(chǎng)離奇詭異矾湃,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)堕澄,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,078評(píng)論 2 385
  • 文/潘曉璐 我一進(jìn)店門邀跃,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人蛙紫,你說我怎么就攤上這事拍屑。” “怎么了坑傅?”我有些...
    開封第一講書人閱讀 156,852評(píng)論 0 347
  • 文/不壞的土叔 我叫張陵僵驰,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我唁毒,道長(zhǎng)蒜茴,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 56,408評(píng)論 1 283
  • 正文 為了忘掉前任浆西,我火速辦了婚禮粉私,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘近零。我一直安慰自己诺核,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,445評(píng)論 5 384
  • 文/花漫 我一把揭開白布秒赤。 她就那樣靜靜地躺著猪瞬,像睡著了一般憎瘸。 火紅的嫁衣襯著肌膚如雪入篮。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,772評(píng)論 1 290
  • 那天幌甘,我揣著相機(jī)與錄音潮售,去河邊找鬼。 笑死锅风,一個(gè)胖子當(dāng)著我的面吹牛酥诽,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播皱埠,決...
    沈念sama閱讀 38,921評(píng)論 3 406
  • 文/蒼蘭香墨 我猛地睜開眼肮帐,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起训枢,我...
    開封第一講書人閱讀 37,688評(píng)論 0 266
  • 序言:老撾萬榮一對(duì)情侶失蹤托修,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后恒界,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體睦刃,經(jīng)...
    沈念sama閱讀 44,130評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,467評(píng)論 2 325
  • 正文 我和宋清朗相戀三年十酣,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了涩拙。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,617評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡耸采,死狀恐怖兴泥,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情虾宇,我是刑警寧澤郁轻,帶...
    沈念sama閱讀 34,276評(píng)論 4 329
  • 正文 年R本政府宣布,位于F島的核電站文留,受9級(jí)特大地震影響好唯,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜燥翅,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,882評(píng)論 3 312
  • 文/蒙蒙 一骑篙、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧森书,春花似錦靶端、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,740評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至猖毫,卻和暖如春台谍,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背吁断。 一陣腳步聲響...
    開封第一講書人閱讀 31,967評(píng)論 1 265
  • 我被黑心中介騙來泰國(guó)打工趁蕊, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人仔役。 一個(gè)月前我還...
    沈念sama閱讀 46,315評(píng)論 2 360
  • 正文 我出身青樓掷伙,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親又兵。 傳聞我的和親對(duì)象是個(gè)殘疾皇子任柜,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,486評(píng)論 2 348