* 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))

fix(repo): update repo urls to `repo.saltproject.io` (inc. fix for `oraclelinux-7`)

Avoid this error:

```
      ID: salt-master
Function: pkg.installed
  Result: False
 Comment: Error occurred installing package(s). Additional info follows:

   errors:
       - Running scope as unit run-402.scope.
         Loaded plugins: ovl, ulninfo
         https://repo.saltproject.io/py3/redhat/7Server/x86_64/3002/repodata/repomd.xml:
             [Errno 14] HTTPS Error 404 - Not Found
         Trying other mirror.
         No package salt-master available.
         Error: Nothing to do
```

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"
```

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

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

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

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

## [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))

fix(freebsd): use `retry_options` to avoid spurious service failures

Use the `retry_options` already being used for the Salt minion service,
since we're getting failures such as this one:

* https://github.com/myii/salt-formula/runs/2415072504

This is made worse by the fact that GitHub Actions cannot re-run a
single job (at the current time).

## [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))

ci(kitchen+gitlab): adjust matrix to add `3003`

* Semi-automated using https://github.com/myii/ssf-formula/pull/318

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

* Semi-automated using https://github.com/myii/ssf-formula/pull/313
* Add Window 10 map verification file

## [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))

Right now when you set module_config entries in your pillar data
like this:
salt:
  minion:
    module_config:
      smtp.from: 'Kali Salt <admins+salt@kali.org>'
      smtp.to: 'Kali Admins <admins+salt@kali.org>'
      smtp.host: localhost
      smtp.subject: 'Results of salt actions on'
      smtp.fields: id,fun

On each run, you will always a different ordering of the various
fields in the minion configuration file, leading to spurious restart
of the minion and admin annoyance:

          ID: salt-minion
    Function: file.recurse
        Name: /etc/salt/minion.d
      Result: True
     Comment: Recursively updated /etc/salt/minion.d
     Started: 13:39:25.689775
    Duration: 874.318 ms
     Changes:
              ----------
              /etc/salt/minion.d/f_defaults.conf:
                  ----------
                  diff:
                      ---
                      +++
                      @@ -930,10 +930,10 @@
                       # A dict for the test module:
                       #test.baz: {spam: sausage, cheese: bread}
                       #
                      +smtp.fields: id,fun
                      +smtp.from: Kali Salt <admins+salt@kali.org>
                       smtp.to: Kali Admins <admins+salt@kali.org>
                      -smtp.fields: id,fun
                       smtp.host: localhost
                      -smtp.from: Kali Salt <admins+salt@kali.org>
                       smtp.subject: Results of salt actions on

With the change here, this bad behaviour is gone...

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

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

Resolves issues introduced in 24ebbb4e0c.

## [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))

ci: enable Vagrant-based testing using GitHub Actions

Fix #495

* Semi-automated using https://github.com/myii/ssf-formula/pull/304

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

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

ci(windows): use `kitchen.windows.yml`

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

# [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))

feat: allow selecting alternate salt package repositories

```
$ GREP_SED="\(pkgrepo: deb http\):" \
  && grep -rl "${GREP_SED}" test/integration/v* \
     | xargs sed -i -e "/${GREP_SED}/s//\1s:/"
```

Make the upstream salt package repository selectable, thus allowing the
use of archived salt versions (hosted in
https://archive.repo.saltproject.io), as well as custom salt versions
hosted in alternate repositories.

## [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))

fix: revert to using `is mapping` in Jinja2

* CVE-2021-25283 enables Jinja2 safe mode, which breaks use of
  `'dict' in x.__class__.__name__` workaround
* Workaround no longer needed as CentOS 6 is EOL

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

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