* docs(readme): add documentation regarding salt.formula usage.

* docs(readme): change salt.formulas documentation to use double backtick.

Co-authored-by: Imran Iqbal <myii@users.noreply.github.com>

## [1.8.5](https://github.com/saltstack-formulas/salt-formula/compare/v1.8.4...v1.8.5) (2021-05-25)

### Bug Fixes

* **oracle-7:** use `osmajorrelease` instead of `$releasever` ([5146c44](5146c449d5))
* **repo:** update repo urls to `repo.saltproject.io` ([80542ba](80542bad6e))

### Continuous Integration

* **vagrant:** add OpenBSD 6.9 [skip ci] ([374527b](374527b235))
* add `arch-master` to matrix and update `.travis.yml` [skip ci] ([b867733](b8677339cc))
* **gitlab-ci:** update Fedora testing after release [skip ci] ([33d6a03](33d6a033d3))

Use the following command:

```
$ GREP_SED="\(repo\.salt\)stack\.com" \
  && grep -rl --exclude-dir=.git "${GREP_SED}" \
  | grep -v .un~$ \
  | xargs sed -i -e "/${GREP_SED}/s//\1project.io/g"
```

## [1.8.4](https://github.com/saltstack-formulas/salt-formula/compare/v1.8.3...v1.8.4) (2021-04-24)

### Bug Fixes

* **freebsd:** use `retry_options` to avoid spurious service failures ([698b7ea](698b7eae59))

## [1.8.3](https://github.com/saltstack-formulas/salt-formula/compare/v1.8.2...v1.8.3) (2021-04-22)

### Continuous Integration

* **kitchen+gitlab:** adjust matrix to add `3003` ([480b7ed](480b7edbfb))
* **vagrant:** add FreeBSD 13.0 [skip ci] ([6316991](6316991334))
* **vagrant:** add Windows 10 pre-salted box [skip ci] ([fd285d8](fd285d8c5b))

### Tests

* **aluminium:** add pillar, tests and verification files for `3003` ([752a1de](752a1dea22))
* **freebsd:** add `map.jinja` verification file (for 13.0) ([10ae613](10ae613cae))

## [1.8.2](https://github.com/saltstack-formulas/salt-formula/compare/v1.8.1...v1.8.2) (2021-04-09)

### Bug Fixes

* **freebsd:** fix package names [skip ci] ([a30f124](a30f124485))

### Continuous Integration

* **vagrant:** use pre-salted boxes & conditional local settings [skip ci] ([5941618](5941618c6e))

### Tests

* **freebsd-11:** fix `osfinger` in comment [skip ci] ([26f2cc1](26f2cc1ef0))

## [1.8.1](https://github.com/saltstack-formulas/salt-formula/compare/v1.8.0...v1.8.1) (2021-03-30)

### Bug Fixes

* **freebsd:** update to provide support for most recent versions ([24ebbb4](24ebbb4e0c))
* **openbsd:** update to provide support for most recent versions ([61201de](61201de8c6))
* **osfamilymap:** use `whoami` for Windows `rootuser` ([69d5981](69d598138e)), closes [#495](https://github.com/saltstack-formulas/salt-formula/issues/495)

### Code Refactoring

* **retry_options:** provide options from defaults/pillar ([bbd7286](bbd7286240))

### Continuous Integration

* enable Vagrant-based testing using GitHub Actions ([163c77f](163c77fcee))
* **kitchen+ci:** use latest pre-salted images (after CVE) [skip ci] ([cfefcc8](cfefcc83c0))
* **windows:** use `kitchen.windows.yml` ([c6043fb](c6043fbc9d))

### Documentation

* **readme:** add `Testing with Vagrant` section ([ef1bc02](ef1bc02a86))

### Tests

* update for new platforms (inc. using `system` library) ([e6bcdc1](e6bcdc1b4d))
* **_mapdata:** add Arch Linux verification file ([e31a56e](e31a56e7a3))
* add Windows map verification files ([e0afe89](e0afe89f24))
* standardise use of `share` suite & `_mapdata` state [skip ci] ([9816f47](9816f473c5))

# [1.8.0](https://github.com/saltstack-formulas/salt-formula/compare/v1.7.5...v1.8.0) (2021-03-03)

### Features

* allow selecting alternate salt package repositories ([8742ab3](8742ab30bb))

### Tests

* **debian+ubuntu:** update `pkgrepo` to use `https` instead of `http` ([e94a8c9](e94a8c9dce))

## [1.7.5](https://github.com/saltstack-formulas/salt-formula/compare/v1.7.4...v1.7.5) (2021-03-02)

### Bug Fixes

* revert to using `is mapping` in Jinja2 ([a89fb3f](a89fb3f4aa))

### Continuous Integration

* **gemfile+lock:** use `ssf` customised `kitchen-docker` repo [skip ci] ([25fea89](25fea89238))
* **kitchen+gitlab-ci:** use latest pre-salted images [skip ci] ([fb9901e](fb9901e3ac))
* **pre-commit:** update hook for `rubocop` [skip ci] ([a874a76](a874a76967))

## [1.7.4](https://github.com/saltstack-formulas/salt-formula/compare/v1.7.3...v1.7.4) (2021-01-29)

### Bug Fixes

* **osfamilymap:** update openSUSE `pkgrepo` URLs ([48f8da0](48f8da0357))
* **pkgrepo/suse/install:** avoid managing repo if it already exists ([d5320a3](d5320a35ed)), closes [/github.com/saltstack/salt/blob/45cc49daed1618dbe89e1f012128c8dcab00b356/salt/modules/zypperpkg.py#L1262-L1265](45cc49daed/salt/modules/zypperpkg.py/issues/L1262-L1265)

### Continuous Integration

* **kitchen+gitlab:** update for new pre-salted images ([a9413e8](a9413e8c29))

### Tests

* **tumbleweed:** add map verification files ([6aeaa5a](6aeaa5ac94))

## [1.7.3](https://github.com/saltstack-formulas/salt-formula/compare/v1.7.2...v1.7.3) (2020-12-23)

### Tests

* **_mapdata:** generate verification files ([da6d150](da6d1509fd))
* **map:** verify `map.jinja` dump using `_mapdata` state ([d2404d5](d2404d5175))

## [1.7.2](https://github.com/saltstack-formulas/salt-formula/compare/v1.7.1...v1.7.2) (2020-12-20)

### Continuous Integration

* **commitlint:** ensure `upstream/master` uses main repo URL [skip ci] ([2a5b679](2a5b6798d4))
* **gitlab-ci:** add `rubocop` linter (with `allow_failure`) [skip ci] ([8417653](8417653525))
* **kitchen+gitlab:** adjust matrix to add `3002` ([7df2445](7df2445481))

### Tests

* **magnesium:** add pillar and tests for `3002` ([c066060](c0660608d7))

## [1.7.1](https://github.com/saltstack-formulas/salt-formula/compare/v1.7.0...v1.7.1) (2020-12-16)

### Continuous Integration

* **gitlab-ci:** use GitLab CI as Travis CI replacement ([c9b2cb4](c9b2cb4a4a))

### Tests

* **fluorine:** remove pillar and tests for `2019.2` ([75ccf59](75ccf591eb))
* **pkgs_spec:** test for major version only (i.e. `3000`) ([618f95a](618f95a665))

# [1.7.0](https://github.com/saltstack-formulas/salt-formula/compare/v1.6.0...v1.7.0) (2020-10-12)

### Continuous Integration

* **pre-commit:** add to formula [skip ci] ([7ff962e](7ff962e2ad))
* **pre-commit:** enable/disable `rstcheck` as relevant [skip ci] ([426b29c](426b29c211))
* **pre-commit:** finalise `rstcheck` configuration [skip ci] ([22fa616](22fa616f59))

### Features

* add Gentoo support ([127c5d7](127c5d779b))

* Automated using https://github.com/myii/ssf-formula/pull/267

# [1.6.0](https://github.com/saltstack-formulas/salt-formula/compare/v1.5.2...v1.6.0) (2020-09-20)

### Features

* enable the metadata grains server by default ([b1d296d](b1d296d270))

## [1.5.2](https://github.com/saltstack-formulas/salt-formula/compare/v1.5.1...v1.5.2) (2020-09-20)

### Bug Fixes

* **jinja:** stop repeating user/group args ([e313401](e313401cd6))
* **windows:** dont run master state ([a36f2eb](a36f2eb2d2))
* **windows:** git.latest(parallel:true) does not work ([0c591bb](0c591bba95))
* **windows:** group arg not supported on windows ([d61e671](d61e671fa0))
* **windows:** group name is users not root ([887d155](887d1559b5))

## [1.5.1](https://github.com/saltstack-formulas/salt-formula/compare/v1.5.0...v1.5.1) (2020-08-25)

### Bug Fixes

* **service:** service salt-master and salt-minion to restart last ([d71cf0c](d71cf0c4f9))
* **service:** svc `salt-master` watch `remove-default-master-conf-file` ([e1774e3](e1774e3b40))

### Styles

* **libtofs.jinja:** use Black-inspired Jinja formatting [skip ci] ([76e820c](76e820c36f))

# [1.5.0](https://github.com/saltstack-formulas/salt-formula/compare/v1.4.6...v1.5.0) (2020-07-15)

### Bug Fixes

* **macos:** use macos service names ([c72b183](c72b183f5f))
* **minion:** fix requisites from recent prs ([a466456](a46645607b))

### Features

* **macos:** basic launchctl service support ([94027f7](94027f7332))

### Tests

* **versions:** bump pkg versions ([37eb3b3](37eb3b3514))

## [1.4.6](https://github.com/saltstack-formulas/salt-formula/compare/v1.4.5...v1.4.6) (2020-07-01)

### Bug Fixes

* **freebsd:** command `at` is already present in base system ([b6ab1b1](b6ab1b1d54))

## [1.4.5](https://github.com/saltstack-formulas/salt-formula/compare/v1.4.4...v1.4.5) (2020-06-28)

### Bug Fixes

* **windows:** `py2` should still be default like other platforms ([62f6d39](62f6d39d63))

### Continuous Integration

* **github:** add Windows testing using Actions ([1eca9c7](1eca9c7551))

### Tests

* **windows:** add local testing of Windows using Vagrant/Virtualbox ([0465af7](0465af72da))

## [1.4.4](https://github.com/saltstack-formulas/salt-formula/compare/v1.4.3...v1.4.4) (2020-06-23)

### Continuous Integration

* **kitchen:** use `saltimages` Docker Hub where available [skip ci] ([f66a09c](f66a09c2d6))
* **kitchen+travis:** adjust matrix to add `3001` ([9060879](9060879924))

### Tests

* **sodium:** add pillar and tests for `3001` ([42cacc2](42cacc253f))

## [1.4.3](https://github.com/saltstack-formulas/salt-formula/compare/v1.4.2...v1.4.3) (2020-06-01)

### Tests

* **pkgs_spec:** simplify using `match` (trigger: update for `suse`) ([b2b1fee](b2b1fee370)), closes [/travis-ci.org/github/myii/salt-formula/jobs/692337807#L2366-L2381](https://github.com//travis-ci.org/github/myii/salt-formula/jobs/692337807/issues/L2366-L2381)

## [1.4.2](https://github.com/saltstack-formulas/salt-formula/compare/v1.4.1...v1.4.2) (2020-05-26)

### Bug Fixes

* **opensuse:** use appropriate upstream repo ([5d9a92b](5d9a92bf1d))

### Continuous Integration

* **kitchen+travis:** adjust matrix to add `3000.3` [skip ci] ([a333801](a3338018fb))
* **kitchen+travis:** adjust matrix to add `opensuse-leap-15.2` ([7fc32fb](7fc32fb0fb))
* **kitchen+travis:** adjust matrix to add `opensuse-leap-15.2` ([1afa84e](1afa84e1af))
* **travis:** add notifications => zulip [skip ci] ([7e2a9c0](7e2a9c0acd))
* **workflows/commitlint:** add to repo [skip ci] ([38ebe56](38ebe5653b))

### Tests

* **pkgs_spec:** update for releases `3000.3` & `2019.2.5` ([5917569](5917569464))
* **pkgs_spec:** update version installed on `fedora` ([301a988](301a9884ac))

## [1.4.1](https://github.com/saltstack-formulas/salt-formula/compare/v1.4.0...v1.4.1) (2020-05-02)

### Continuous Integration

* **gemfile.lock:** add to repo with updated `Gemfile` [skip ci] ([f10a85f](f10a85fc70))
* **kitchen+travis:** adjust matrix to add `3000.2` & remove `2018.3` ([433a2c1](433a2c1597))

### Tests

* add tests for `v3000-py2` ([c228029](c228029879))
* **pkgs_spec:** update for CVE releases `3000.2` & `2019.2.4` ([965588b](965588b108))
* remove deprecated Salt/Python versions ([7f19796](7f19796517))

# [1.4.0](https://github.com/saltstack-formulas/salt-formula/compare/v1.3.4...v1.4.0) (2020-04-18)

### Features

* **package:** use apt-pinning to pin specific package version ([98ad87a](98ad87a001))

### Tests

* **pkgs_spec:** update `fedora` version [skip ci] ([e786eb6](e786eb6b8e))

## [1.3.4](https://github.com/saltstack-formulas/salt-formula/compare/v1.3.3...v1.3.4) (2020-04-03)

### Bug Fixes

* **api:** remove spurious colon in salt.api state ([02fbcd4](02fbcd43fc))

## [1.3.3](https://github.com/saltstack-formulas/salt-formula/compare/v1.3.2...v1.3.3) (2020-04-01)

### Continuous Integration

* **kitchen+travis:** adjust matrix to update `3000` to `3000.1` ([a8fe65a](a8fe65a2c8))

### Tests

* **pkgs_spec:** update `3000` to `3000.1` ([1e677cd](1e677cd761))
* **service_spec:** add `should be_installed` ([b5461a0](b5461a0eba))

## [1.3.2](https://github.com/saltstack-formulas/salt-formula/compare/v1.3.1...v1.3.2) (2020-03-21)

### Code Refactoring

* **osfamilymap:** remove workaround for OpenSUSE 15.1 ([0da366c](0da366c7b2))

### Continuous Integration

* **kitchen+travis:** adjust matrix to add `3000` & remove `2017.7` ([4a5f805](4a5f8053e9))

### Tests

* **neon:** add pillar and tests for `3000` ([f91f10c](f91f10c280))
* **nitrogen:** remove pillar and tests for `2017.7` ([f246a5e](f246a5e0af))

## [1.3.1](https://github.com/saltstack-formulas/salt-formula/compare/v1.3.0...v1.3.1) (2020-03-19)

### Bug Fixes

* **jinja:** replace version_cmp with grains lookup ([dd37869](dd37869d28))
* **jinja:** replace version_cmp with grains lookup ([325f6c0](325f6c061b))

# [1.3.0](https://github.com/saltstack-formulas/salt-formula/compare/v1.2.0...v1.3.0) (2020-03-11)

### Features

* **mapping:** better control of the service's state ([29ffd68](29ffd68d34))

# [1.2.0](https://github.com/saltstack-formulas/salt-formula/compare/v1.1.3...v1.2.0) (2020-02-20)

### Bug Fixes

* **libtofs:** “files_switch” mess up the variable exported by “map.jinja” [skip ci] ([4955737](4955737f84))

### Continuous Integration

* **kitchen+travis+inspec:** fix `amazonlinux-2-py3` [skip ci] ([10e2ce0](10e2ce07a4))

### Features

* **metastate:** add metastate per community convention ([fbaa456](fbaa456ca6))

## [1.1.3](https://github.com/saltstack-formulas/salt-formula/compare/v1.1.2...v1.1.3) (2020-02-13)

### Bug Fixes

* **tpl_path:** replace slspath to tplroot ([bbcc4cd](bbcc4cda7a))

### Continuous Integration

* **kitchen:** avoid using bootstrap for `master` instances [skip ci] ([d2d5186](d2d51864a5))

## [1.1.2](https://github.com/saltstack-formulas/salt-formula/compare/v1.1.1...v1.1.2) (2020-01-25)

### Code Refactoring

* **mapping:** simplify py version handling ([715e3b8](715e3b8fa4))

## [1.1.1](https://github.com/saltstack-formulas/salt-formula/compare/v1.1.0...v1.1.1) (2020-01-24)

### Continuous Integration

* **travis:** use `major.minor` for `semantic-release` version [skip ci] ([9d30df2](9d30df2f5f))

### Tests

* **pkgs_spec:** update `centos-8` for `2019.2.3` release ([7121d1d](7121d1d8cd))
* **versions:** bump salt pkg versions ([c42125c](c42125c2ab))

# [1.1.0](https://github.com/saltstack-formulas/salt-formula/compare/v1.0.0...v1.1.0) (2019-12-19)

### Features

* **formulas:** git.latest parallelization ([eda88bd](eda88bd1a6))

# [1.0.0](https://github.com/saltstack-formulas/salt-formula/compare/v0.59.9...v1.0.0) (2019-12-16)

### Continuous Integration

* **gemfile:** restrict `train` gem version until upstream fix [skip ci] ([fdc60ae](fdc60aed86))

### Features

* **per-formula-opts:** configure git.latest state per formula ([82c840d](82c840d6f9))
* **per-formula-opts:** configure git.latest state per formula ([9362277](9362277f2a))

### BREAKING CHANGES

* **per-formula-opts:** Potential adverse affect on running `salt.formulas` with multiple envs

## [0.59.9](https://github.com/saltstack-formulas/salt-formula/compare/v0.59.8...v0.59.9) (2019-12-03)

### Tests

* **pkgs_spec:** update for new `opensuse` package ([6da3d0d](6da3d0d935)), closes [/travis-ci.com/saltstack-formulas/salt-formula/jobs/261961203#L1619-L1632](https://github.com//travis-ci.com/saltstack-formulas/salt-formula/jobs/261961203/issues/L1619-L1632)

## [0.59.8](https://github.com/saltstack-formulas/salt-formula/compare/v0.59.7...v0.59.8) (2019-11-28)

### Bug Fixes

* **release.config.js:** use full commit hash in commit link [skip ci] ([67e1109](67e110973b))
* **shellcheck:** fix shellcheck error ([cc31514](cc3151436c))

### Continuous Integration

* **travis:** apply changes from build config validation [skip ci] ([56c2eb5](56c2eb5367))
* **travis:** opt-in to `dpl v2` to complete build config validation [skip ci] ([33f69cf](33f69cfb7b))
* **travis:** quote pathspecs used with `git ls-files` [skip ci] ([1a27b0a](1a27b0ae84))
* **travis:** run `shellcheck` during lint job [skip ci] ([f4e8ae6](f4e8ae6871))
* **travis:** use build config validation (beta) [skip ci] ([85593f5](85593f555e))

### Performance Improvements

* **travis:** improve `salt-lint` invocation [skip ci] ([ef7e1c1](ef7e1c1e7b))

## [0.59.7](https://github.com/saltstack-formulas/salt-formula/compare/v0.59.6...v0.59.7) (2019-10-29)

### Continuous Integration

* **kitchen+travis:** upgrade matrix after `2019.2.2` release ([](https://github.com/saltstack-formulas/salt-formula/commit/b6e3a83))
* **travis:** update `salt-lint` config for `v0.0.10` [skip ci] ([](https://github.com/saltstack-formulas/salt-formula/commit/4cbf0b2))

### Documentation

* **contributing:** remove to use org-level file instead [skip ci] ([](https://github.com/saltstack-formulas/salt-formula/commit/78d0fee))
* **readme:** update link to `CONTRIBUTING` [skip ci] ([](https://github.com/saltstack-formulas/salt-formula/commit/924817b))

### Tests

* **pkgs_spec:** update for `2019.2.2` release ([](https://github.com/saltstack-formulas/salt-formula/commit/acbc238))

* Automated using https://github.com/myii/ssf-formula/pull/70

## [0.59.6](https://github.com/saltstack-formulas/salt-formula/compare/v0.59.5...v0.59.6) (2019-10-11)

### Tests

* **pkgs_spec:** reset version from `2019.2.1` back to `2019.2.0` ([](https://github.com/saltstack-formulas/salt-formula/commit/4787ce7))

## [0.59.5](https://github.com/saltstack-formulas/salt-formula/compare/v0.59.4...v0.59.5) (2019-10-11)

### Bug Fixes

* **rubocop:** add fixes using `rubocop --safe-auto-correct` ([](https://github.com/saltstack-formulas/salt-formula/commit/62f82a4))

### Continuous Integration

* merge travis matrix, add `salt-lint` & `rubocop` to `lint` job ([](https://github.com/saltstack-formulas/salt-formula/commit/64c6ba9))
* **travis:** merge `rubocop` linter into main `lint` job ([](https://github.com/saltstack-formulas/salt-formula/commit/4ea85e8))

## [0.59.4](https://github.com/saltstack-formulas/salt-formula/compare/v0.59.3...v0.59.4) (2019-10-10)

### Bug Fixes

* **map.jinja:** fix `salt-lint` errors ([](https://github.com/saltstack-formulas/salt-formula/commit/5b348eb))
* **minion.sls:** fix `salt-lint` errors ([](https://github.com/saltstack-formulas/salt-formula/commit/3e63977))
* **syndic.sls:** fix `salt-lint` errors ([](https://github.com/saltstack-formulas/salt-formula/commit/ef4ad1e))

### Continuous Integration

* **kitchen:** install required packages to bootstrapped `opensuse` [skip ci] ([](https://github.com/saltstack-formulas/salt-formula/commit/8cc5952))
* **kitchen:** use bootstrapped `opensuse` images until `2019.2.2` [skip ci] ([](https://github.com/saltstack-formulas/salt-formula/commit/0c5eb7e))
* **platform:** add `arch-base-latest` (commented out for now) [skip ci] ([](https://github.com/saltstack-formulas/salt-formula/commit/8f36788))
* merge travis matrix, add `salt-lint` & `rubocop` to `lint` job ([](https://github.com/saltstack-formulas/salt-formula/commit/e815eaa))

## [0.59.3](https://github.com/saltstack-formulas/salt-formula/compare/v0.59.2...v0.59.3) (2019-09-25)

### Continuous Integration

* **kitchen:** change `log_level` to `debug` instead of `info` ([073175d](https://github.com/saltstack-formulas/salt-formula/commit/073175d))

### Tests

* **pkgs_spec:** update for `2019.2.1` release ([1bf9689](https://github.com/saltstack-formulas/salt-formula/commit/1bf9689))

## [0.59.2](https://github.com/saltstack-formulas/salt-formula/compare/v0.59.1...v0.59.2) (2019-09-20)

### Bug Fixes

* **symlinks:** replace symlinks with real files ([c4d0132](https://github.com/saltstack-formulas/salt-formula/commit/c4d0132))