Skip to content
If you build software, keep a changelog.
HTML Ruby CSS JavaScript
Branch: master
Clone or download

Latest commit

olivierlacan Bump lockfile to Bundler 2
# Title

# Tell me everything!

# Co-authors (they will be credited on GitHub as well)
# Co-authored-by: Carolina Powers <>
# Co-authored-by: Meg Kline-Tuls <>
# Co-authored-by: Will <>
# Co-authored-by: thatchej <>
Latest commit d906341 Mar 10, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
source add Georgian (ka) translation (#337) Mar 10, 2020
.editorconfig Add charset config to .editorconfig Jul 28, 2016
.gitignore Swedish translation of v1.0.0 Jun 20, 2017
.ruby-version Bump to Ruby 2.7 Mar 10, 2020 Update 1.1 changelog Mar 10, 2020 Format all the markdown files with markdownlint (#318) Oct 21, 2019 Rewrite README to focus on development Aug 6, 2016
Gemfile Bump middleman from 4.3.5 to 4.3.6 (#335) Mar 10, 2020
Gemfile.lock Bump lockfile to Bundler 2 Mar 10, 2020
LICENSE Convert static files to a Middleman app. Oct 18, 2015 Remove Docker Mar 10, 2020
Rakefile Convert static files to a Middleman app. Oct 18, 2015
config.rb add Georgian (ka) translation (#337) Mar 10, 2020

Keep a Changelog

Keep a Changelog v1.1.0 badge Version 1.1.0 Badge MIT License Badge

Don’t let your friends dump git logs into changelogs™

This repository generates




  • git clone
  • cd keep-a-changelog
  • bundle install
  • bundle exec middleman starts the local development server at http://localhost:4567


  • bundle exec rake publish builds and pushes to the gh-pages branch


Create a new directory in source/ named after the ISO 639-1 code for the language you wish to translate Keep a Changelog to. For example, assuming you want to translate to French Canadian:

  • create the source/fr-CA directory.
  • duplicate the source/en/1.0.0/index.html.haml file in source/fr-CA.
  • edit source/fr-CA/1.0.0/index.html.haml until your translation is ready.
  • commit your changes to your own fork
  • submit a Pull Request with your changes

It may take some time to review your submitted Pull Request. Try to involve a few native speakers of the language you're translating to in the Pull Request comments. They'll help review your translation for simple mistakes and give us a better idea of whether your translation is accurate.


Please do contribute! Issues and pull requests are welcome.

Thank you for your help improving software one changelog at a time!

You can’t perform that action at this time.