Changelog
See the latest product updates and bug fixes here
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Unreleased
Added
- Addedv1.1 Brazilian Portuguese translation.
- Addedv1.1 German Translation
- Addedv1.1 Spanish translation.
- Addedv1.1 Italian translation.
- Addedv1.1 Polish translation.
- Addedv1.1 Ukrainian translation.
Changed
- ChangedUse frontmatter title & description in each language version template
- ChangedReplace broken OpenGraph image with an appropriately-sized Keep a Changelog image that will render properly (although in English for all languages)
- ChangedFix OpenGraph title & description for all languages so the title and description when links are shared are language-appropriate
Removed
- RemovedTrademark sign previously shown after the project description in version 0.3.0
1.1.1 - 2023-03-05
Added
- AddedArabic translation (#444).
- Addedv1.1 French translation.
- Addedv1.1 Dutch translation (#371).
- Addedv1.1 Russian translation (#410).
- Addedv1.1 Japanese translation (#363).
- Addedv1.1 Norwegian Bokmål translation (#383).
- Addedv1.1 "Inconsistent Changes" Turkish translation (#347).
- AddedDefault to most recent versions available for each languages.
- AddedDisplay count of available translations (26 to date!).
- AddedCentralize all links into
/data/links.json
so they can be updated easily.
Fixed
- FixedImprove French translation (#377).
- FixedImprove id-ID translation (#416).
- FixedImprove Persian translation (#457).
- FixedImprove Russian translation (#408).
- FixedImprove Swedish title (#419).
- FixedImprove zh-CN translation (#359).
- FixedImprove French translation (#357).
- FixedImprove zh-TW translation (#360, #355).
- FixedImprove Spanish (es-ES) transltion (#362).
- FixedFoldout menu in Dutch translation (#371).
- FixedMissing periods at the end of each change (#451).
- FixedFix missing logo in 1.1 pages.
- FixedDisplay notice when translation isn't for most recent version.
- FixedVarious broken links, page versions, and indentations.
Changed
- ChangedUpgrade dependencies: Ruby 3.2.1, Middleman, etc.
Removed
- RemovedUnused normalize.css file.
- RemovedIdentical links assigned in each translation file.
- RemovedDuplicate index file for the english version.
1.1.0 - 2019-02-15
Added
- AddedDanish translation (#297).
- AddedGeorgian translation from (#337).
- AddedChangelog inconsistency section in Bad Practices.
Fixed
- FixedItalian translation (#332).
- FixedIndonesian translation (#336).
1.0.0 - 2017-06-20
Added
- AddedNew visual identity by @tylerfortune8.
- AddedVersion navigation.
- AddedLinks to latest released version in previous versions.
- Added"Why keep a changelog?" section.
- Added"Who needs a changelog?" section.
- Added"How do I make a changelog?" section.
- Added"Frequently Asked Questions" section.
- AddedNew "Guiding Principles" sub-section to "How do I make a changelog?".
- AddedSimplified and Traditional Chinese translations from @tianshuo.
- AddedGerman translation from @mpbzh & @Art4.
- AddedItalian translation from @azkidenz.
- AddedSwedish translation from @magol.
- AddedTurkish translation from @emreerkan.
- AddedFrench translation from @zapashcanon.
- AddedBrazilian Portuguese translation from @Webysther.
- AddedPolish translation from @amielucha & @m-aciek.
- AddedRussian translation from @aishek.
- AddedCzech translation from @h4vry.
- AddedSlovak translation from @jkostolansky.
- AddedKorean translation from @pierceh89.
- AddedCroatian translation from @porx.
- AddedPersian translation from @Hameds.
- AddedUkrainian translation from @osadchyi-s.
Changed
- ChangedStart using "changelog" over "change log" since it's the common usage.
- ChangedStart versioning based on the current English version at 0.3.0 to help translation authors keep things up-to-date.
- ChangedRewrite "What makes unicorns cry?" section.
- ChangedRewrite "Ignoring Deprecations" sub-section to clarify the ideal scenario.
- ChangedImprove "Commit log diffs" sub-section to further argument against them.
- ChangedMerge "Why can’t people just use a git log diff?" with "Commit log diffs".
- ChangedFix typos in Simplified Chinese and Traditional Chinese translations.
- ChangedFix typos in Brazilian Portuguese translation.
- ChangedFix typos in Turkish translation.
- ChangedFix typos in Czech translation.
- ChangedFix typos in Swedish translation.
- ChangedImprove phrasing in French translation.
- ChangedFix phrasing and spelling in German translation.
Removed
- RemovedSection about "changelog" vs "CHANGELOG".
0.3.0 - 2015-12-03
Added
- AddedRU translation from @aishek.
- Addedpt-BR translation from @tallesl.
- Addedes-ES translation from @ZeliosAriex.
0.2.0 - 2015-10-06
Changed
- ChangedRemove exclusionary mentions of "open source" since this project can benefit both "open" and "closed" source projects equally.
0.1.0 - 2015-10-06
Added
- AddedAnswer "Should you ever rewrite a change log?".
Changed
- ChangedImprove argument against commit logs.
- ChangedStart following SemVer properly.
0.0.8 - 2015-02-17
Changed
- ChangedUpdate year to match in every README example.
- ChangedReluctantly stop making fun of Brits only, since most of the world writes dates in a strange way.
Fixed
- FixedFix typos in recent README changes.
- FixedUpdate outdated unreleased diff link.
0.0.7 - 2015-02-16
Added
- AddedLink, and make it obvious that date format is ISO 8601.
Changed
- ChangedClarified the section on "Is there a standard change log format?".
Fixed
- FixedFix Markdown links to tag comparison URL with footnote-style links.
0.0.6 - 2014-12-12
Added
- AddedREADME section on "yanked" releases.
0.0.5 - 2014-08-09
Added
- AddedMarkdown links to version tags on release headings.
- AddedUnreleased section to gather unreleased changes and encourage note keeping prior to releases.
0.0.4 - 2014-08-09
Added
- AddedBetter explanation of the difference between the file ("CHANGELOG") and its function "the change log".
Changed
- ChangedRefer to a "change log" instead of a "CHANGELOG" throughout the site to differentiate between the file and the purpose of the file — the logging of changes.
Removed
- RemovedRemove empty sections from CHANGELOG, they occupy too much space and create too much noise in the file. People will have to assume that the missing sections were intentionally left out because they contained no notable changes.
0.0.3 - 2014-08-09
Added
- Added"Why should I care?" section mentioning The Changelog podcast.
0.0.2 - 2014-07-10
Added
- AddedExplanation of the recommended reverse chronological release ordering.
0.0.1 - 2014-05-31
Added
- AddedThis CHANGELOG file to hopefully serve as an evolving example of a standardized open source project CHANGELOG.
- AddedCNAME file to enable GitHub Pages custom domain.
- AddedREADME now contains answers to common questions about CHANGELOGs.
- AddedGood examples and basic guidelines, including proper date formatting.
- AddedCounter-examples: "What makes unicorns cry?".
Have questions? We're here to help
Trusted by organizations across the world



