Contents

# Releasing

Follow these steps to release a new version of bootstrap_form to rubygems.org.

## Prerequisites

* You must have commit rights to the bootstrap_form repository.
* You must have push rights for the bootstrap_form gem on rubygems.org.
* You must be using a Ruby version that is not end-of-life.

## How to release

1. Determine which would be the correct next version number according to [semver](http://semver.org/).
2. Update the version in `./lib/bootstrap_form/version.rb`.
3. Make sure that you have all the gems necessary for testing and releasing.

       BUNDLE_GEMFILE=gemfiles/7.0.gemfile bundle update

4. **Ensure the tests are passing by running the tests**

   (There should be no errors or warnings.)

       BUNDLE_GEMFILE=gemfiles/7.0.gemfile bundle exec rake test

5. **Ensure the demo tests are passing by running**

       cd demo
       bundle update
       bundle exec rake test:all
       cd -

6. Update the GitHub diff links at the beginning of `CHANGELOG.md` (The pattern should be obvious when you look at them).
7. Update the installation instructions in `README.md` to use the new version.
8. Commit the CHANGELOG and version changes in a single commit; the message should be "Preparing vX.Y.Z" where `X.Y.Z` is the version being released.
9. Tag, push to GitHub, and publish to rubygems.org:

       bundle exec rake release

10. Go to https://github.com/bootstrap-ruby/bootstrap_form/releases and create the new release and add release notes by clicking the "Generate release notes" button.
    Add the link of closed issues from CHANGELOG.
    Group the commits in sections:
    * ### New features
    * ### Bugfixes
    * ### Performance
    * ### Documentation
    * ### Development

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
bootstrap_form-5.3.2	RELEASING.md
bootstrap_form-5.3.1	RELEASING.md
bootstrap_form-5.3.0	RELEASING.md
bootstrap_form-5.2.3	RELEASING.md