Product Code Database
Example Keywords: pokimon -ocarina $86
barcode-scavenger
   » » Wiki: Changelog
Tag Wiki 'Changelog'.
Tag

Changelog
 (

A changelog is a log or record of all notable changes made to a project. The project is often a or software project, and the changelog usually includes records of changes such as bug fixes, new features, etc. Some projects include a changelog as one of the top level files in their distribution.

A changelog has historically included all changes made to a project. The "Keep a CHANGELOG" site instead advocates that a changelog not include all changes, but that it should instead contain "a curated, chronologically ordered list of notable changes for each version of a project" and should not be a "dump" of a git log "because this helps nobody".

Although the canonical naming convention for the file is ChangeLog, The GNU automake manual it is sometimes alternatively named as CHANGES or HISTORY ( NEWS is usually a different file reflecting changes between releases, not between the commits). Another convention is to call it a CHANGELOG. Some project maintainers will append a .txt suffix to the file name if the changelog is , or a .md suffix if it is in .

Some systems are able to generate the relevant information that is suited as a changelog if the goal is to include all changes.


Format
Changelog files are organized by paragraphs, which define a unique change within a function or file. The GNU Coding standards recommend the following format:
YYYY-MM-DD  John Doe  
     

   * myfile.ext (myfunction): my changes made
   additional changes
     

   * myfile.ext (unrelated_change): my changes made
   to myfile.ext but completely unrelated to the above
     

   * anotherfile.ext (somefunction): more changes
     

Note that between the date and the name, and again between the name and the email address, there are two spaces each. It is common to enclose the email address in < and >. The creates such entries when creating additional changelog entries.


Changelogs in Wikis
Most software includes changelogs as a fundamental feature (often called history in this context). For example, the "View History" link at the top of a entry links to that page's changelog. This feature is vital for complying with the attribution requirements of some copyright licenses.


See also


Notes

External links

Page 1 of 1
1
Page 1 of 1
1

Account

Social:
Pages:  ..   .. 
Items:  .. 

Navigation

General: Atom Feed Atom Feed  .. 
Help:  ..   .. 
Category:  ..   .. 
Media:  ..   .. 
Posts:  ..   ..   .. 

Statistics

Page:  .. 
Summary:  .. 
1 Tags
10/10 Page Rank
5 Page Refs