diff --git a/AUTHORS.md b/AUTHORS.md
index e69de29..cf2df35 100644
--- a/AUTHORS.md
+++ b/AUTHORS.md
@@ -0,0 +1,13 @@
+# Authors
+
+This list is sorted by the number of commits per contributor in _descending_ order.
+
+Avatar|Contributor|Contributions
+:-:|---|:-:
+<img class='float-left rounded-1' src='https://avatars1.githubusercontent.com/u/13322818?v=4' width='36' height='36' alt='@noelmcloughlin'>|[@noelmcloughlin](/~https://github.com/noelmcloughlin)|69
+<img class='float-left rounded-1' src='https://avatars2.githubusercontent.com/u/10231489?v=4' width='36' height='36' alt='@myii'>|[@myii](/~https://github.com/myii)|2
+<img class='float-left rounded-1' src='https://avatars0.githubusercontent.com/u/1800660?v=4' width='36' height='36' alt='@aboe76'>|[@aboe76](/~https://github.com/aboe76)|1
+
+---
+
+Auto-generated by a [forked version](/~https://github.com/myii/maintainer) of [gaocegege/maintainer](/~https://github.com/gaocegege/maintainer) on 2020-05-12.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e69de29..edd9cd1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,21 @@
+# Changelog
+
+# [1.0.0](/~https://github.com/saltstack-formulas/jetbrains-intellij-formula/compare/v0.5.0...v1.0.0) (2020-05-12)
+
+
+### Documentation
+
+* **readme:** add depth one ([1e6f0ea](/~https://github.com/saltstack-formulas/jetbrains-intellij-formula/commit/1e6f0ea00dcad78f9b45094ebbb480bf665b2292))
+
+
+### Features
+
+* **formula:** align to template formula ([ad9b6a3](/~https://github.com/saltstack-formulas/jetbrains-intellij-formula/commit/ad9b6a390d8c8fcb64b1e5d26f55911ba5c42952))
+* **semantic-release:** standardise for this formula ([541add1](/~https://github.com/saltstack-formulas/jetbrains-intellij-formula/commit/541add1f7bde4f92472772e968c151a3c55fa659))
+
+
+### BREAKING CHANGES
+
+* **formula:** Major refactor of formula to bring it in alignment with the
+template-formula. As with all substantial changes, please ensure your
+existing configurations work in the ways you expect from this formula.
diff --git a/FORMULA b/FORMULA
index a637d74..b679228 100644
--- a/FORMULA
+++ b/FORMULA
@@ -1,7 +1,7 @@
 name: intellij
 os: Debian, Ubuntu, Raspbian, RedHat, Fedora, CentOS, Amazon, 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: 0.2.2
+version: 1.0.0
 release: 1
 minimum_version: 2019.2
 summary: intellij formula
diff --git a/docs/AUTHORS.rst b/docs/AUTHORS.rst
index e69de29..c4b4bbd 100644
--- a/docs/AUTHORS.rst
+++ b/docs/AUTHORS.rst
@@ -0,0 +1,29 @@
+.. 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:`<img class='float-left rounded-1' src='https://avatars1.githubusercontent.com/u/13322818?v=4' width='36' height='36' alt='@noelmcloughlin'>`
+     - `@noelmcloughlin </~https://github.com/noelmcloughlin>`_
+     - 69
+   * - :raw-html-m2r:`<img class='float-left rounded-1' src='https://avatars2.githubusercontent.com/u/10231489?v=4' width='36' height='36' alt='@myii'>`
+     - `@myii </~https://github.com/myii>`_
+     - 2
+   * - :raw-html-m2r:`<img class='float-left rounded-1' src='https://avatars0.githubusercontent.com/u/1800660?v=4' width='36' height='36' alt='@aboe76'>`
+     - `@aboe76 </~https://github.com/aboe76>`_
+     - 1
+
+
+----
+
+Auto-generated by a `forked version </~https://github.com/myii/maintainer>`_ of `gaocegege/maintainer </~https://github.com/gaocegege/maintainer>`_ on 2020-05-12.
diff --git a/docs/CHANGELOG.rst b/docs/CHANGELOG.rst
index e69de29..ac772cc 100644
--- a/docs/CHANGELOG.rst
+++ b/docs/CHANGELOG.rst
@@ -0,0 +1,27 @@
+
+Changelog
+=========
+
+`1.0.0 </~https://github.com/saltstack-formulas/jetbrains-intellij-formula/compare/v0.5.0...v1.0.0>`_ (2020-05-12)
+--------------------------------------------------------------------------------------------------------------------
+
+Documentation
+^^^^^^^^^^^^^
+
+
+* **readme:** add depth one (\ `1e6f0ea </~https://github.com/saltstack-formulas/jetbrains-intellij-formula/commit/1e6f0ea00dcad78f9b45094ebbb480bf665b2292>`_\ )
+
+Features
+^^^^^^^^
+
+
+* **formula:** align to template formula (\ `ad9b6a3 </~https://github.com/saltstack-formulas/jetbrains-intellij-formula/commit/ad9b6a390d8c8fcb64b1e5d26f55911ba5c42952>`_\ )
+* **semantic-release:** standardise for this formula (\ `541add1 </~https://github.com/saltstack-formulas/jetbrains-intellij-formula/commit/541add1f7bde4f92472772e968c151a3c55fa659>`_\ )
+
+BREAKING CHANGES
+^^^^^^^^^^^^^^^^
+
+
+* **formula:** Major refactor of formula to bring it in alignment with the
+  template-formula. As with all substantial changes, please ensure your
+  existing configurations work in the ways you expect from this formula.