Skip to content

Latest commit

 

History

History
48 lines (30 loc) · 1.44 KB

updating-the-changelog.md

File metadata and controls

48 lines (30 loc) · 1.44 KB

guidelines for debian/changelog file

Starting from oq-engine 1.4, hazardlib 0.14.0 it is possible to add new items with the description of new functionalities and/or bug fixes to the debian/changelog file without breaking the continuous integration and including these items in the nightly-build packages changelog when merged.

keep debian/changelog updated

New items in debian/changelog are mandatory for any pull request with new major functionalities and/or important bug fixes.

New items must be added at the top of the file.

debian/changelog items format


⎵⎵[<author name and surname>]<newline (␤)>

⎵⎵*⎵<feature-bugfix description not exceeding 80 characters><␤>

⎵⎵⎵⎵<optional description continuation><␤>

⎵⎵*⎵<another feature-bugfix description of the same author><␤>

... other features-bugfix descriptions of the same author ...

<␤>


Example

  [Yen-Shin Chen]
  * enable to change the hypocentre location.

  [Marco Pagani]
  * Gridsource added
  * Another important feature to show a coupled item of the
    same author

  [Michele Simionato]
  * Added a test sensitive to the underlying distance libraries
    that allow us to have a more long comment

Notes

  • a good item description length is between 1 and 3 or 4 lines
  • no empty lines before a new item
  • just one empty line after a new item