Difference between revisions of "Changelog"

From GeeklogWiki
Jump to: navigation, search
(Some rough guidelines for the changelog (history))
 
(link to description of listchanges.php)
 
Line 15: Line 15:
 
** if the change was mainly the act of applying a patch, credit should go to the author of the patch
 
** if the change was mainly the act of applying a patch, credit should go to the author of the patch
 
** use common sense
 
** use common sense
 +
 +
== Getting a list of changes ==
 +
 +
A (raw) list of changes that went into a specific Geeklog version can be acquired through a [[List of Changes|script]].
  
  
 
[[Category:Development]] [[Category:Internals]]
 
[[Category:Development]] [[Category:Internals]]

Latest revision as of 12:54, 6 April 2012

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

Getting a list of changes

A (raw) list of changes that went into a specific Geeklog version can be acquired through a script.