項目發佈歷史文件

Question

我有一個在GitHub上託管的開源項目。 每次發佈我該死的項目後，我想寫出一些文件的新功能和錯誤修復列表，如History.md。它看起來像：

=== Version 0.0.1 2012-12-21 

Version with a new awesome bugs has been released 

* [added] New feature 
* [fixed] Some bug fixed 

但我猶豫。可能是我錯了嗎？我不知道，所以我問。是否有任何關於如何格式化歷史變更的指導方針/規則/建議/良好的期限/任何其他內容？或者，也許更改列表不應該是一個單一的文件？

或者更一般地說：對Github（或任何其他主機）項目來說，跟蹤版本更改（當然是以人類可讀的格式）並以更愉快的方式將其加入項目本身的最佳方式是什麼？