Difference between revisions of "Changelog"

From GeeklogWiki
Jump to: navigation, search
(Some rough guidelines for the changelog (history))
(No difference)

Revision as of 12:20, 30 November 2009

A changelog file is a list of all changes in a software project. Geeklog's changelog file is called history and located in public_html/docs/history. The file is maintained manually, using the following guidelines:

Formatting

  • plain text
  • 80 characters per line
  • latest changes first
  • separate sections for core and plugin changes (core first, one section per plugin)

Content

  • if a change was made to fix a bug or implement a requested feature, add the issue number from our bugtracker, e.g.
    Fixed foo handling in bar plugin (bug #0012345)
  • give credit where credit is due
    • the person(s) making the change should add their name in square brackets at the end of the change description
    • if the change was mainly the act of applying a patch, credit should go to the author of the patch
    • use common sense