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

This repository generates https://keepachangelog.com/.

Development

Dependencies

• Ruby (see version, rbenv recommended)
• Bundler (gem install bundler)

Installation

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

Deployment

The deployment utilizes Middleman Github Pages to build and publish to GitHub Pages in the following steps

Create gh-pages branch if it's not there yet:

git checkout -b gh-pages master
git push origin gh-pages

Build and publish the page

rm -rf build
bundle exec rake publish

⚠️ For your life, health, and the persons who love you, do NOT use Ruby's Addressable::URI.join for the God sake.

This fork deploys version 1.0.0

Translations

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.

Contribute

Please do contribute! Issues and pull requests are welcome.

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