Skip to content
This repository has been archived by the owner on Jun 16, 2023. It is now read-only.

Add python-systemd to Debian Jessie repository #657

Closed
kaaelhaa opened this issue Feb 27, 2019 · 7 comments
Closed

Add python-systemd to Debian Jessie repository #657

kaaelhaa opened this issue Feb 27, 2019 · 7 comments

Comments

@kaaelhaa
Copy link

With the release of Salt 2019.2.0 our automated deployments of Salt with the virt runner has stopped working.

We're deploying VMs based on the official Debian OpenStack images (as we then don't need to maintain these ourselves). These images does not include the Debian backports repository which is required for resolving the python-systemd dependency.

Please consider adding python-systemd to the Salt Debian repository, as our automated deployments currently are ... not so automated.

@dmurphy18
Copy link
Contributor

@kaaelhaa The aim of the SaltStack repositories for both Redhat/Amazon/Debian/Ubuntu are to provide Salt for that platform and any dependencies which the OS platform does not supply at a sufficient version for Salt to function. For example: Debian 8.0 did not supply python-systemd initially but now does since v8.5. Python-tornado v4.2.1 was provided initially since versions shipped were insufficient versions for Salt to operate, but subsequently newer versions are now supplied by OS platforms.

It was found during testing, that some conflicts were occurring between the version of python-systemd built by SaltStack and that provided by the Debian OS and it was decided to stop continuing building and providing python-systemd and defer to the version provided by the OS platform, especially since the conflicts prevented installation.

Hope that this explains the reasons for removing it.

@myii
Copy link

myii commented Feb 28, 2019

For Docker, using debian:jessie-backports has worked for us (the reference link directly above).

saltstack-formulas-travis pushed a commit to saltstack-formulas/template-formula that referenced this issue Feb 28, 2019
# [1.0.0](v0.7.6...v1.0.0) (2019-02-28)

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com//pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com//pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com//pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com//pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com//pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [#50](#50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)

### Documentation

* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** fix typos ([007159a](007159a))

### Features

* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Feb 28, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-02-28)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** use include for `README.rst` in `docs` and test RTD ([f073d36](f073d36))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **rtd:** conduct further tests ([0e29290](0e29290))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Feb 28, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-02-28)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** use include for `README.rst` in `docs` and test RTD ([f073d36](f073d36))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **rtd:** conduct further tests ([c6520bf](c6520bf))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 1, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-01)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** format table for better layout ([25586ae](25586ae))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** use `conf.py` to add custom `css` ([cb94e3b](cb94e3b))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 1, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-01)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** format table for better layout ([25586ae](25586ae))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** use `conf.py` to add custom `css` ([5b0ebe0](5b0ebe0))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
@getSurreal
Copy link

For kitchen tests using vagrant you can inject backports into it.

platforms:
  - name: bento/debian-8.7
    lifecycle:
      post_create:
      - remote: echo 'deb http://deb.debian.org/debian jessie-backports main' | sudo tee -a /etc/apt/sources.list
      - remote: sudo apt-get update

myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([0b8b0c8](0b8b0c8))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([04db4e4](04db4e4))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([0a8afd3](0a8afd3))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([f6edb65](f6edb65))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([dadfb37](dadfb37))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([af75d87](af75d87))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([6d68925](6d68925))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([dd96b16](dd96b16))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 3, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-03)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([7646d41](7646d41))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
myii pushed a commit to myii/template-formula that referenced this issue Mar 6, 2019
# [1.0.0](v0.2.0...v1.0.0) (2019-03-06)

### Bug Fixes

* **pillar:** fix `os_family` typo ([3f89c12](3f89c12))
* **tofs:** update comments in `files_switch` macro for new method ([3fa3640](3fa3640))
* **tofs:** use `tpldir` derivative `topdir` for pillar (config) paths ([5e9df00](5e9df00))

### Code Refactoring

* **components:** split components into separate subdirs ([d957055](d957055)), closes [/github.com/saltstack-formulas/pull/48#pullrequestreview-207182085](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/pullrequestreview-207182085) [/github.com/saltstack-formulas/pull/48#discussion_r259805312](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259805312)
* **include+require:** use variable for duplicate values ([4443518](4443518))
* **kitchen:** prefer `kitchen.yml` to `.kitchen.yml` ([3860bf9](3860bf9))
* **macros:** use `tplroot` instead of `topdir` to match `tpldata` ([923b459](923b459))
* **pkg:** change to `package` instead ([2cd82e5](2cd82e5)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259951123](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259951123)
* **pkg:** move `pkg` related components into separate directory ([c21f82b](c21f82b))
* **states:** set state IDs based on a dependable structure ([6690ee6](6690ee6)), closes [/github.com/saltstack-formulas/pull/48#discussion_r259953473](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259953473) [/github.com/saltstack-formulas/pull/48#discussion_r259956996](https://github.com//github.com/saltstack-formulas/template-formula/pull/48/issues/discussion_r259956996)
* **topdir:** use for `include` and `require` except `init.sls` ([a218e91](a218e91))
* **tpldir:** use `topdir` globally in place of `tpldir` ([2838bc9](2838bc9))
* **tpldir:** use `tpldir` or derivatives to make formula portable ([52d03d8](52d03d8)), closes [saltstack-formulas#22](https://github.com/myii/template-formula/issues/22)
* **tplroot:** use `tplroot` instead of `topdir` to match `tpldata` ([b7356b0](b7356b0))

### Continuous Integration

* **kitchen:** check for repos updates before trying package installation ([b632383](b632383))
* **kitchen:** improve comments about `opensuse` problems encountered ([c246939](c246939))
* **kitchen:** specify `image` explicitly for each platform ([b25fbdc](b25fbdc))
* **kitchen:** use `salt-minion` version of `opensuse` to ensure tests run ([99b073a](99b073a))
* **kitchen+travis:** disable `debian-8` due to `2019.2` installation bug ([178c710](178c710))
* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([1b9d249](1b9d249)), closes [saltstack-formulas#50](https://github.com/myii/template-formula/issues/50) [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-467932962](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-467932962)
* **travis:** include `commitlint` stage ([6659a69](6659a69))
* **travis:** prevent `release` stage running for PRs ([3a072c7](3a072c7)), closes [/travis-ci.com/saltstack-formulas/template-formula/jobs/180068519#L466](https://github.com//travis-ci.com/saltstack-formulas/template-formula/jobs/180068519/issues/L466) [/github.com/saltstack-formulas/pull/42#issuecomment-466446324](https://github.com//github.com/saltstack-formulas/template-formula/pull/42/issues/issuecomment-466446324)
* **travis:** remove obsolete `markdown-toc` process ([97fbb60](97fbb60))
* **travis:** remove obsolete check based on `$TRAVIS_TEST_RESULT` ([6df9c95](6df9c95))
* **travis:** remove unavailable files from `markdown-toc` process ([3148f0d](3148f0d))

### Documentation

* **changelog:** add missing entry under `v0.3.2` ([50352b5](50352b5))
* **changelog:** merge previous `rst` into new `md` format ([2b4e485](2b4e485))
* **changelog:** remove erroneous "closes" used by `semantic-release` ([be4571d](be4571d))
* **components:** update for separation of `pkg`, `config` & `service` ([726fcab](726fcab))
* **contributing:** add basic introductory text before the TOC ([45ccaf6](45ccaf6))
* **contributing:** add commit message formatting instructions ([fb3d173](fb3d173))
* **contributing:** add documentation contribution guidelines ([dff0ee8](dff0ee8))
* **contributing:** add TOC to match all other pages ([7b1a2a9](7b1a2a9))
* **contributing:** centre-align version bump columns in table ([a238cae](a238cae))
* **contributing:** convert to `.rst` and move to `docs` subdir ([474f318](474f318))
* **contributing:** create blank template ([3633e8f](3633e8f))
* **contributing:** modify quoted heading to prevent TOC inclusion ([abcb6ef](abcb6ef))
* **contributing:** separate `BREAKING CHANGE` under its own heading ([ee053d7](ee053d7))
* **contributing:** update with sub-headings and `commitlint` details ([ea2c9a4](ea2c9a4))
* **index:** add `CONTRIBUTING` to the `toctree` ([0c98e67](0c98e67))
* **readme:** add Read the Docs build status badge ([f47797d](f47797d))
* **readme:** add suggested improvement to `template.service.clean` ([bf1039c](bf1039c))
* **readme:** convert note into a heading ([5f2d789](5f2d789))
* **readme:** fix typos ([007159a](007159a))
* **readme:** move under `docs` subdir to access in both GitHub and RTD ([c92f674](c92f674))
* **readme:** update heading markers for consistency ([5a2bea8](5a2bea8))
* **rtd:** add basic `docs/conf.py` to allow additional customisation ([18d3924](18d3924))
* **rtd:** add basic `index.rst` to allow RTD to produce docs ([f02139f](f02139f))
* **rtd:** add comment to CSS file for overriding in-use Sphinx theme ([f237364](f237364))
* **rtd:** clean up numerous issues and inconsistencies ([ad5a8b8](ad5a8b8))
* **rtd:** use internal link targets at the top of each `.rst` file ([da09528](da09528))
* **tofs:** add more sub-headings to ease document navigation ([2c5dc21](2c5dc21))
* **tofs:** apply language formatting to source code blocks ([0638413](0638413))
* **tofs:** explain how all parts of the `source` can be customised ([2f82eb5](2f82eb5)), closes [saltstack-formulas#44](https://github.com/myii/template-formula/issues/44)
* **tofs:** improve general use of language ([5105d29](5105d29))
* **tofs:** replace existing `.md` with `.rst` and add to RTD ([fd68168](fd68168))
* **tofs:** update the `files_switch` section for the updated macro ([788f732](788f732))
* **tofs:** use `{%-` for all Jinja statements ([4348df8](4348df8))
* **tofs:** use `literalinclude` of `macros.jinja` instead of code dupe ([3f0071b](3f0071b))
* **tofs:** use table to list authorship ([2f0e20f](2f0e20f))
* **yaml:** os*.yaml map files needs at least an empty dict ([dd99750](dd99750))

### Features

* **authors:** update automatically alongside `semantic-release` ([8000098](8000098))
* **kitchen+travis:** add `opensuse-leap` after resolving issues ([7614a3c](7614a3c))
* **kitchen+travis:** conduct tests on a wider range of platforms ([1348078](1348078))
* **m2r:** use `m2r` to convert automatic `.md` files to `.rst` ([b86ddf4](b86ddf4))
* **pkg:** add `clean` states ([422c7ac](422c7ac))
* **pkg:** use `require` requisite between `pkg` states ([6e7141b](6e7141b)), closes [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py#L120](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/jinja.py/issues/L120) [/github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py#L145](https://github.com//github.com/saltstack/salt/blob/0c78d7dc894058988d171a28a11bd4a9dbf60266/salt/utils/templates.py/issues/L145) [/github.com/saltstack/salt/issues/10838#issuecomment-391718086](https://github.com//github.com/saltstack/salt/issues/10838/issues/issuecomment-391718086)
* **rtd:** provide custom CSS file for overriding in-use Sphinx theme ([24bd338](24bd338))
* **semantic-release:** configure for this formula ([cbcfd75](cbcfd75))
* **toc:** use `markdown-toc` directly to update inline ([a5bae1e](a5bae1e))
* **tofs:** implement backwards-compatible TOFSv2 for configurability ([068a94d](068a94d)), closes [/freenode.logbot.info/saltstack-formulas/20190214#c1995273](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995273) [/freenode.logbot.info/saltstack-formulas/20190214#c1995487](https://github.com//freenode.logbot.info/saltstack-formulas/20190214/issues/c1995487)

### Reverts

* **kitchen+travis:** disable `debian-8` due to `2019.2` bug ([e8f0f7e](e8f0f7e))

### Tests

* **inspec:** update `supports` for all platforms added ([42f93b3](42f93b3))

### BREAKING CHANGES

* **states:** Wholesale state ID changes will break implementations
that are relying on the previous state IDs for requisite purposes.
* **pkg:** Changing the `pkg` directory to `package` will break
implementations that are depending on `pkg` for `include` or `sls`-based
requisite purposes.
@kaaelhaa
Copy link
Author

@dmurphy18 I totally understand your reasoning but I must say I do not agree that python-systemd is part of default Debian 8 (Jessie) distribution.

The package can only be fetched from the jessie-backports repository, which for many reasons is not enabled by default - not event present in /etc/apt/sources.list. You need to manually add it which is exactly what #657 (comment) and #657 (comment) does above. This is why I ask you to please reconsider the removal of python-systemd from the Debian Jessie Salt repository, as the current state is a breaking change.

In comparison, Debian 9 (Stretch) has python-systemd in the default repository.

@dmurphy18 dmurphy18 added this to the March 29th milestone Mar 19, 2019
@dmurphy18
Copy link
Contributor

@kaaelhaa Dug deeper into this issue and you are correct in stating the default Debian 8 (jessie) distribution: my apologies.

From installing Debian 8.7 with a VirtualBox VM
python-systemd is available from jessie-backports, for example:
root@t8min:/home/david# apt-cache policy python-systemd
python-systemd:
Installed: (none)
Candidate: 233-1bpo8+1
Version table:
233-1
bpo8+1 0
100 http://ftp.us.debian.org/debian/ jessie-backports/main amd64 Packages
root@t8min:/home/david# lsb_release -a
No LSB modules are available.
Distributor ID: Debian
Description: Debian GNU/Linux 8.7 (jessie)
Release: 8.7
Codename: jessie
root@t8min:/home/david#

The conflict that I encountered is due to using AWS and building on a Debian 8.7 system (without backports explicitly in /etc/apt/sources.list) but AWS is supplying python-systemd as follows:

root@ip-10-200-13-140:/home/admin# apt-cache policy python-systemd
python-systemd:
Installed: 231-2bpo8+1
Candidate: 233-1
bpo8+1
Version table:
233-1bpo8+1 0
750 http://cloudfront.debian.net/debian/ jessie-backports/main amd64 Packages
*** 231-2
bpo8+1 0
100 /var/lib/dpkg/status
root@ip-10-200-13-140:/home/admin# cat /etc/apt/sources.list
deb http://cloudfront.debian.net/debian jessie main contrib non-free
deb http://security.debian.org/ jessie/updates main contrib non-free
deb http://cloudfront.debian.net/debian jessie-updates main contrib non-free
deb http://repo.saltstack.com/apt/debian/8/amd64/latest jessie main
root@ip-10-200-13-140:/home/admin#

I failed to check /etc/apt/sources.list.d for backports.list. I shall re-work the build environment for building Jessie to eliminate jessie-backports, which was the original intention, and this should appear in the next point release.

@dmurphy18
Copy link
Contributor

@kaaelhaa Both of the Salt 2018.3.4 and 2019.2.0 for Debian 8 on amd64 repositories have been updated with a restored python-systemd package.

Sorry for the breakage and thanks for bringing this issue up.

If this resolves your issue, please close or if there is still an issue, please let me know asap.

myii added a commit to myii/template-formula that referenced this issue Mar 24, 2019
This reverts commit 1b9d249.

* vmware-archive/salt-pack#657 (comment)
  - `python-systemd` is now available in the SaltStack repo
* Amended the commit to add: `image: debian:8`
saltstack-formulas-travis pushed a commit to saltstack-formulas/template-formula that referenced this issue Mar 24, 2019
## [1.2.6](v1.2.5...v1.2.6) (2019-03-24)

### Reverts

* **kitchen+travis:** use `debian:jessie-backports` as `debian-8` ([dcd141a](dcd141a)), closes [/github.com/vmware-archive/salt-pack/issues/657#issuecomment-474954298](https://github.com//github.com/saltstack/salt-pack/issues/657/issues/issuecomment-474954298)
@dmurphy18
Copy link
Contributor

@kaaelhaa Closing this since fix has been available for 2 weeks and no issues, Please re-open this issue if the problem reoccurs

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

4 participants