diff --git a/AUTHORS.md b/AUTHORS.md
new file mode 100644
index 00000000..5d5a25a8
--- /dev/null
+++ b/AUTHORS.md
@@ -0,0 +1,17 @@
+# Authors
+
+This list is sorted by the number of commits per contributor in _descending_ order.
+
+Avatar|Contributor|Contributions
+:-:|---|:-:
+|[@noelmcloughlin](https://github.com/noelmcloughlin)|20
+|[@aboe76](https://github.com/aboe76)|9
+|[@alxwr](https://github.com/alxwr)|6
+|[@0xf10e](https://github.com/0xf10e)|6
+|[@javierbertoli](https://github.com/javierbertoli)|2
+|[@juadk](https://github.com/juadk)|2
+|[@nmadhok](https://github.com/nmadhok)|1
+
+---
+
+Auto-generated by a [forked version](https://github.com/myii/maintainer) of [gaocegege/maintainer](https://github.com/gaocegege/maintainer) on 2019-10-04.
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..771565cf
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,70 @@
+# Changelog
+
+# 1.0.0 (2019-10-04)
+
+
+### Bug Fixes
+
+* **arch:** harden jinja for archlinux ([4ec440c](https://github.com/saltstack-formulas/iscsi-formula/commit/4ec440c))
+* **archlinux:** update osfamilymap ([ea82c99](https://github.com/saltstack-formulas/iscsi-formula/commit/ea82c99))
+* **clean:** fix clean kernel state ([a31079c](https://github.com/saltstack-formulas/iscsi-formula/commit/a31079c))
+* **clean:** fix clean states ([f4224fc](https://github.com/saltstack-formulas/iscsi-formula/commit/f4224fc))
+* **config:** only generate custom config if pillar data supplied ([8664023](https://github.com/saltstack-formulas/iscsi-formula/commit/8664023))
+* **defaults:** fix username on archlinux ([6dfa8a1](https://github.com/saltstack-formulas/iscsi-formula/commit/6dfa8a1))
+* **freebsd:** loader.conf is existing file ([d4d176f](https://github.com/saltstack-formulas/iscsi-formula/commit/d4d176f))
+* **freebsd:** required changes for freebsd 11.2 ([1ef79ec](https://github.com/saltstack-formulas/iscsi-formula/commit/1ef79ec))
+* **isns:** fix jinja in config file template ([8dfc993](https://github.com/saltstack-formulas/iscsi-formula/commit/8dfc993))
+* **jinja:** fix error while parsing a flow ([8d9d959](https://github.com/saltstack-formulas/iscsi-formula/commit/8d9d959))
+* **jinja:** fixes for file management ([2575062](https://github.com/saltstack-formulas/iscsi-formula/commit/2575062))
+* **kernel:** fix kernel module states ([0fca2fa](https://github.com/saltstack-formulas/iscsi-formula/commit/0fca2fa))
+* **kernelmod:** refactor kernel states ([9aac15a](https://github.com/saltstack-formulas/iscsi-formula/commit/9aac15a))
+* **os:** better os mapping ([55e4cfb](https://github.com/saltstack-formulas/iscsi-formula/commit/55e4cfb))
+* **os:** fix open-iscsi on archlinux ([43b2ad4](https://github.com/saltstack-formulas/iscsi-formula/commit/43b2ad4))
+* **saltbug:** file.line is buggy; use file.prepend ([f72fe9e](https://github.com/saltstack-formulas/iscsi-formula/commit/f72fe9e))
+* **saltbug:** fix for strange 'unless: ' bug ([5de113d](https://github.com/saltstack-formulas/iscsi-formula/commit/5de113d))
+* **service:** only start service if enabled ([b8d8b7f](https://github.com/saltstack-formulas/iscsi-formula/commit/b8d8b7f))
+* **suse:** service is called targetcli on Suse15 ([4f37896](https://github.com/saltstack-formulas/iscsi-formula/commit/4f37896))
+* **target:** increase volsize and minor fixes ([9c50ef9](https://github.com/saltstack-formulas/iscsi-formula/commit/9c50ef9))
+* **target:** some minor fixes ([ab04191](https://github.com/saltstack-formulas/iscsi-formula/commit/ab04191))
+* **template:** comments not supported by json standard ([433d647](https://github.com/saltstack-formulas/iscsi-formula/commit/433d647))
+* **tgt:** fix for tgtadm: invalid request ([de4b9f0](https://github.com/saltstack-formulas/iscsi-formula/commit/de4b9f0))
+* **travis:** travis wants loop4-7 ([7671bec](https://github.com/saltstack-formulas/iscsi-formula/commit/7671bec))
+* **ubuntu:** fix target service name on ubuntu ([36c63a7](https://github.com/saltstack-formulas/iscsi-formula/commit/36c63a7))
+* **ubuntu:** update list of default packages ([bf99361](https://github.com/saltstack-formulas/iscsi-formula/commit/bf99361))
+
+
+### Code Refactoring
+
+* **formula:** align to template-formula & fix [#19](https://github.com/saltstack-formulas/iscsi-formula/issues/19) ([dfb5b27](https://github.com/saltstack-formulas/iscsi-formula/commit/dfb5b27))
+* **osmaps:** add osfinger, osmap ([add55e0](https://github.com/saltstack-formulas/iscsi-formula/commit/add55e0))
+
+
+### Documentation
+
+* **archlinux:** add user to pillar.example ([4b09216](https://github.com/saltstack-formulas/iscsi-formula/commit/4b09216))
+* **example:** update pillars for travis ([ffc2ddd](https://github.com/saltstack-formulas/iscsi-formula/commit/ffc2ddd))
+* **lint:** fix lint errors & skip service on centos/travis ([1a6161f](https://github.com/saltstack-formulas/iscsi-formula/commit/1a6161f))
+* **readme:** list all states ([930fb9e](https://github.com/saltstack-formulas/iscsi-formula/commit/930fb9e))
+* **readme:** update description ([02cad31](https://github.com/saltstack-formulas/iscsi-formula/commit/02cad31))
+* **readme:** update documentation re. targets ([c90f86d](https://github.com/saltstack-formulas/iscsi-formula/commit/c90f86d))
+* **suse:** update pillar example packages ([ff54b33](https://github.com/saltstack-formulas/iscsi-formula/commit/ff54b33))
+* **unused:** removing depreciated docs/ files ([118a2d6](https://github.com/saltstack-formulas/iscsi-formula/commit/118a2d6))
+
+
+### Features
+
+* **kernel:** advice re kernel upgrades ([77d3625](https://github.com/saltstack-formulas/iscsi-formula/commit/77d3625))
+
+
+### Tests
+
+* **arch/cent:** updated kitchen tests ([d519be1](https://github.com/saltstack-formulas/iscsi-formula/commit/d519be1))
+* **lint:** fix yamllint errors ([2ab2b3e](https://github.com/saltstack-formulas/iscsi-formula/commit/2ab2b3e))
+* **matrix:** choose appropriate os ([42d9f7a](https://github.com/saltstack-formulas/iscsi-formula/commit/42d9f7a))
+* **travis:** add dependency to lvm; update pillar data ([fb694a0](https://github.com/saltstack-formulas/iscsi-formula/commit/fb694a0))
+* **travis:** add travis yml ([828f827](https://github.com/saltstack-formulas/iscsi-formula/commit/828f827))
+* **travis:** change loop0-3 to loop4-7 ([17d3833](https://github.com/saltstack-formulas/iscsi-formula/commit/17d3833))
+* **travis:** fix centos7 kernel ([b562cb0](https://github.com/saltstack-formulas/iscsi-formula/commit/b562cb0))
+* **travis:** fixup yamllint ([9690093](https://github.com/saltstack-formulas/iscsi-formula/commit/9690093))
+* **travis:** no iscsi target package for amazonlinux ([d2f2b4e](https://github.com/saltstack-formulas/iscsi-formula/commit/d2f2b4e))
+* **travis:** workaround travis nuances ([61502c9](https://github.com/saltstack-formulas/iscsi-formula/commit/61502c9))
diff --git a/FORMULA b/FORMULA
index 287336da..5ef7183f 100644
--- a/FORMULA
+++ b/FORMULA
@@ -1,7 +1,7 @@
name: iscsi
os: Debian, Ubuntu, Raspbian, RedHat, Fedora, CentOS, Suse, openSUSE, Gentoo, Funtoo, Arch, Manjaro, Alpine, FreeBSD, OpenBSD, Solaris, SmartOS, Windows, MacOS
os_family: Debian, RedHat, Suse, Gentoo, Arch, Alpine, FreeBSD, OpenBSD, Solaris, Windows, MacOS
-version: 3.3.0
+version: 1.0.0
release: 1
minimum_version: 2017.7
summary: iscsi formula
diff --git a/docs/AUTHORS.rst b/docs/AUTHORS.rst
new file mode 100644
index 00000000..707bd50b
--- /dev/null
+++ b/docs/AUTHORS.rst
@@ -0,0 +1,41 @@
+.. role:: raw-html-m2r(raw)
+ :format: html
+
+
+Authors
+=======
+
+This list is sorted by the number of commits per contributor in *descending* order.
+
+.. list-table::
+ :header-rows: 1
+
+ * - Avatar
+ - Contributor
+ - Contributions
+ * - :raw-html-m2r:``
+ - `@noelmcloughlin `_
+ - 20
+ * - :raw-html-m2r:``
+ - `@aboe76 `_
+ - 9
+ * - :raw-html-m2r:``
+ - `@alxwr `_
+ - 6
+ * - :raw-html-m2r:``
+ - `@0xf10e `_
+ - 6
+ * - :raw-html-m2r:``
+ - `@javierbertoli `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@juadk `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@nmadhok `_
+ - 1
+
+
+----
+
+Auto-generated by a `forked version `_ of `gaocegege/maintainer `_ on 2019-10-04.
diff --git a/docs/CHANGELOG.rst b/docs/CHANGELOG.rst
new file mode 100644
index 00000000..af37738a
--- /dev/null
+++ b/docs/CHANGELOG.rst
@@ -0,0 +1,81 @@
+.. role:: raw=html=m2r(raw)
+ :format: html
+
+
+Changelog
+---------
+
+1.0.0 (2019-10-04)
+------------------
+
+Bug Fixes
+^^^^^^^^^
+
+
+* **arch:** harden jinja for archlinux (\ `4ec440c `_\ )
+* **archlinux:** update osfamilymap (\ `ea82c99 `_\ )
+* **clean:** fix clean kernel state (\ `a31079c `_\ )
+* **clean:** fix clean states (\ `f4224fc `_\ )
+* **config:** only generate custom config if pillar data supplied (\ `8664023 `_\ )
+* **defaults:** fix username on archlinux (\ `6dfa8a1 `_\ )
+* **freebsd:** loader.conf is existing file (\ `d4d176f `_\ )
+* **freebsd:** required changes for freebsd 11.2 (\ `1ef79ec `_\ )
+* **isns:** fix jinja in config file template (\ `8dfc993 `_\ )
+* **jinja:** fix error while parsing a flow (\ `8d9d959 `_\ )
+* **jinja:** fixes for file management (\ `2575062 `_\ )
+* **kernel:** fix kernel module states (\ `0fca2fa `_\ )
+* **kernelmod:** refactor kernel states (\ `9aac15a `_\ )
+* **os:** better os mapping (\ `55e4cfb `_\ )
+* **os:** fix open-iscsi on archlinux (\ `43b2ad4 `_\ )
+* **saltbug:** file.line is buggy; use file.prepend (\ `f72fe9e `_\ )
+* **saltbug:** fix for strange 'unless: :raw-html-m2r:``\ ' bug (\ `5de113d `_\ )
+* **service:** only start service if enabled (\ `b8d8b7f `_\ )
+* **suse:** service is called targetcli on Suse15 (\ `4f37896 `_\ )
+* **target:** increase volsize and minor fixes (\ `9c50ef9 `_\ )
+* **target:** some minor fixes (\ `ab04191 `_\ )
+* **template:** comments not supported by json standard (\ `433d647 `_\ )
+* **tgt:** fix for tgtadm: invalid request (\ `de4b9f0 `_\ )
+* **travis:** travis wants loop4-7 (\ `7671bec `_\ )
+* **ubuntu:** fix target service name on ubuntu (\ `36c63a7 `_\ )
+* **ubuntu:** update list of default packages (\ `bf99361 `_\ )
+
+Code Refactoring
+^^^^^^^^^^^^^^^^
+
+
+* **formula:** align to template-formula & fix `#19 `_ (\ `dfb5b27 `_\ )
+* **osmaps:** add osfinger, osmap (\ `add55e0 `_\ )
+
+Documentation
+^^^^^^^^^^^^^
+
+
+* **archlinux:** add user to pillar.example (\ `4b09216 `_\ )
+* **example:** update pillars for travis (\ `ffc2ddd `_\ )
+* **lint:** fix lint errors & skip service on centos/travis (\ `1a6161f `_\ )
+* **readme:** list all states (\ `930fb9e `_\ )
+* **readme:** update description (\ `02cad31 `_\ )
+* **readme:** update documentation re. targets (\ `c90f86d `_\ )
+* **suse:** update pillar example packages (\ `ff54b33 `_\ )
+* **unused:** removing depreciated docs/ files (\ `118a2d6 `_\ )
+
+Features
+^^^^^^^^
+
+
+* **kernel:** advice re kernel upgrades (\ `77d3625 `_\ )
+
+Tests
+^^^^^
+
+
+* **arch/cent:** updated kitchen tests (\ `d519be1 `_\ )
+* **lint:** fix yamllint errors (\ `2ab2b3e `_\ )
+* **matrix:** choose appropriate os (\ `42d9f7a `_\ )
+* **travis:** add dependency to lvm; update pillar data (\ `fb694a0 `_\ )
+* **travis:** add travis yml (\ `828f827 `_\ )
+* **travis:** change loop0-3 to loop4-7 (\ `17d3833 `_\ )
+* **travis:** fix centos7 kernel (\ `b562cb0 `_\ )
+* **travis:** fixup yamllint (\ `9690093 `_\ )
+* **travis:** no iscsi target package for amazonlinux (\ `d2f2b4e `_\ )
+* **travis:** workaround travis nuances (\ `61502c9 `_\ )