diff --git a/AUTHORS.md b/AUTHORS.md
new file mode 100644
index 0000000..b25c701
--- /dev/null
+++ b/AUTHORS.md
@@ -0,0 +1,93 @@
+# Authors
+
+This list is sorted by the number of commits per contributor in _descending_ order.
+
+Avatar|Contributor|Contributions
+:-:|---|:-:
+|[@aboe76](https://github.com/aboe76)|37
+|[@gravyboat](https://github.com/gravyboat)|30
+|[@puneetk](https://github.com/puneetk)|14
+|[@nmadhok](https://github.com/nmadhok)|13
+|[@whiteinge](https://github.com/whiteinge)|13
+|[@noelmcloughlin](https://github.com/noelmcloughlin)|12
+|[@techhat](https://github.com/techhat)|10
+|[@hatifnatt](https://github.com/hatifnatt)|10
+|[@babilen5](https://github.com/babilen5)|9
+|[@kossmac](https://github.com/kossmac)|7
+|[@myii](https://github.com/myii)|7
+|[@arthurlogilab](https://github.com/arthurlogilab)|6
+|[@pcdummy](https://github.com/pcdummy)|6
+|[@alxwr](https://github.com/alxwr)|6
+|[@pprkut](https://github.com/pprkut)|5
+|[@bkmit](https://github.com/bkmit)|4
+|[@stp-ip](https://github.com/stp-ip)|4
+|[@spoage](https://github.com/spoage)|4
+|[@madflojo](https://github.com/madflojo)|4
+|[@tiger-seo](https://github.com/tiger-seo)|4
+|[@daschatten](https://github.com/daschatten)|4
+|[@ashb](https://github.com/ashb)|3
+|[@tardypad](https://github.com/tardypad)|3
+|[@javierbertoli](https://github.com/javierbertoli)|3
+|[@johtso](https://github.com/johtso)|3
+|[@TJuberg](https://github.com/TJuberg)|3
+|[@outime](https://github.com/outime)|3
+|[@ashokrajar](https://github.com/ashokrajar)|3
+|[@0xf10e](https://github.com/0xf10e)|3
+|[@jasonvoor](https://github.com/jasonvoor)|3
+|[@IMBArator](https://github.com/IMBArator)|3
+|[@auser](https://github.com/auser)|3
+|[@7oku](https://github.com/7oku)|2
+|[@hipikat](https://github.com/hipikat)|2
+|[@amontalban](https://github.com/amontalban)|2
+|[@sacr0](https://github.com/sacr0)|2
+|[@bsundsrud](https://github.com/bsundsrud)|2
+|[@iggy](https://github.com/iggy)|2
+|[@eedgar](https://github.com/eedgar)|2
+|[@duk3luk3](https://github.com/duk3luk3)|2
+|[@jerryjvl](https://github.com/jerryjvl)|2
+|[@t0fik](https://github.com/t0fik)|2
+|[@xenophonf](https://github.com/xenophonf)|2
+|[@rhertzog](https://github.com/rhertzog)|2
+|[@roedie](https://github.com/roedie)|2
+|[@sevrob](https://github.com/sevrob)|2
+|[@qno](https://github.com/qno)|2
+|[@tomduijf](https://github.com/tomduijf)|2
+|[@xen0n](https://github.com/xen0n)|2
+|[@jraby](https://github.com/jraby)|2
+|[@luitzifa](https://github.com/luitzifa)|2
+|[@gnuts](https://github.com/gnuts)|2
+|[@sroegner](https://github.com/sroegner)|2
+|[@c10b10](https://github.com/c10b10)|1
+|[@andrew-vant](https://github.com/andrew-vant)|1
+|[@colekowalski](https://github.com/colekowalski)|1
+|[@UtahDave](https://github.com/UtahDave)|1
+|[@diegows](https://github.com/diegows)|1
+|[@Takios](https://github.com/Takios)|1
+|[@garethhowell](https://github.com/garethhowell)|1
+|[@cornmander](https://github.com/cornmander)|1
+|[@glecoquierre](https://github.com/glecoquierre)|1
+|[@dulgheru](https://github.com/dulgheru)|1
+|[@inthecloud247](https://github.com/inthecloud247)|1
+|[@chenmen](https://github.com/chenmen)|1
+|[@philpep](https://github.com/philpep)|1
+|[@ChronoPositron](https://github.com/ChronoPositron)|1
+|[@Cottser](https://github.com/Cottser)|1
+|[@SMillerDev](https://github.com/SMillerDev)|1
+|[@skandyla](https://github.com/skandyla)|1
+|[@iamseth](https://github.com/iamseth)|1
+|[@shawnbutts](https://github.com/shawnbutts)|1
+|[@smlloyd](https://github.com/smlloyd)|1
+|[@SkypLabs](https://github.com/SkypLabs)|1
+|[@slawekp](https://github.com/slawekp)|1
+|[@soniah](https://github.com/soniah)|1
+|[@titilambert](https://github.com/titilambert)|1
+|[@tobio](https://github.com/tobio)|1
+|[@tomasfejfar](https://github.com/tomasfejfar)|1
+|[@adnanJP](https://github.com/adnanJP)|1
+|[@ketzacoatl](https://github.com/ketzacoatl)|1
+|[@maschinetheist](https://github.com/maschinetheist)|1
+|[@nike38rus](https://github.com/nike38rus)|1
+
+---
+
+Auto-generated by a [forked version](https://github.com/myii/maintainer) of [gaocegege/maintainer](https://github.com/gaocegege/maintainer) on 2019-08-07.
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..4fb09c1
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,8 @@
+# Changelog
+
+# [0.47.0](https://github.com/saltstack-formulas/users-formula/compare/v0.46.1...v0.47.0) (2019-08-07)
+
+
+### Features
+
+* **semantic-release:** implement for this formula ([3bcdc90](https://github.com/saltstack-formulas/users-formula/commit/3bcdc90)), closes [#203](https://github.com/saltstack-formulas/users-formula/issues/203)
diff --git a/FORMULA b/FORMULA
index 6b8b06e..e84c609 100644
--- a/FORMULA
+++ b/FORMULA
@@ -1,7 +1,7 @@
name: users
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: 0.46.1
+version: 0.47.0
release: 1
minimum_version: 2017.7
summary: users formula
diff --git a/docs/AUTHORS.rst b/docs/AUTHORS.rst
new file mode 100644
index 0000000..bfcbf28
--- /dev/null
+++ b/docs/AUTHORS.rst
@@ -0,0 +1,269 @@
+.. 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:``
+ - `@aboe76 `_
+ - 37
+ * - :raw-html-m2r:``
+ - `@gravyboat `_
+ - 30
+ * - :raw-html-m2r:``
+ - `@puneetk `_
+ - 14
+ * - :raw-html-m2r:``
+ - `@nmadhok `_
+ - 13
+ * - :raw-html-m2r:``
+ - `@whiteinge `_
+ - 13
+ * - :raw-html-m2r:``
+ - `@noelmcloughlin `_
+ - 12
+ * - :raw-html-m2r:``
+ - `@techhat `_
+ - 10
+ * - :raw-html-m2r:``
+ - `@hatifnatt `_
+ - 10
+ * - :raw-html-m2r:``
+ - `@babilen5 `_
+ - 9
+ * - :raw-html-m2r:``
+ - `@kossmac `_
+ - 7
+ * - :raw-html-m2r:``
+ - `@myii `_
+ - 7
+ * - :raw-html-m2r:``
+ - `@arthurlogilab `_
+ - 6
+ * - :raw-html-m2r:``
+ - `@pcdummy `_
+ - 6
+ * - :raw-html-m2r:``
+ - `@alxwr `_
+ - 6
+ * - :raw-html-m2r:``
+ - `@pprkut `_
+ - 5
+ * - :raw-html-m2r:``
+ - `@bkmit `_
+ - 4
+ * - :raw-html-m2r:``
+ - `@stp-ip `_
+ - 4
+ * - :raw-html-m2r:``
+ - `@spoage `_
+ - 4
+ * - :raw-html-m2r:``
+ - `@madflojo `_
+ - 4
+ * - :raw-html-m2r:``
+ - `@tiger-seo `_
+ - 4
+ * - :raw-html-m2r:``
+ - `@daschatten `_
+ - 4
+ * - :raw-html-m2r:``
+ - `@ashb `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@tardypad `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@javierbertoli `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@johtso `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@TJuberg `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@outime `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@ashokrajar `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@0xf10e `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@jasonvoor `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@IMBArator `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@auser `_
+ - 3
+ * - :raw-html-m2r:``
+ - `@7oku `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@hipikat `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@amontalban `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@sacr0 `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@bsundsrud `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@iggy `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@eedgar `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@duk3luk3 `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@jerryjvl `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@t0fik `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@xenophonf `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@rhertzog `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@roedie `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@sevrob `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@qno `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@tomduijf `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@xen0n `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@jraby `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@luitzifa `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@gnuts `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@sroegner `_
+ - 2
+ * - :raw-html-m2r:``
+ - `@c10b10 `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@andrew-vant `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@colekowalski `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@UtahDave `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@diegows `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@Takios `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@garethhowell `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@cornmander `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@glecoquierre `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@dulgheru `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@inthecloud247 `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@chenmen `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@philpep `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@ChronoPositron `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@Cottser `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@SMillerDev `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@skandyla `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@iamseth `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@shawnbutts `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@smlloyd `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@SkypLabs `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@slawekp `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@soniah `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@titilambert `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@tobio `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@tomasfejfar `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@adnanJP `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@ketzacoatl `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@maschinetheist `_
+ - 1
+ * - :raw-html-m2r:``
+ - `@nike38rus `_
+ - 1
+
+
+----
+
+Auto-generated by a `forked version `_ of `gaocegege/maintainer `_ on 2019-08-07.
diff --git a/docs/CHANGELOG.rst b/docs/CHANGELOG.rst
new file mode 100644
index 0000000..bb86979
--- /dev/null
+++ b/docs/CHANGELOG.rst
@@ -0,0 +1,12 @@
+
+Changelog
+=========
+
+`0.47.0 `_ (2019-08-07)
+----------------------------------------------------------------------------------------------------------
+
+Features
+^^^^^^^^
+
+
+* **semantic-release:** implement for this formula (\ `3bcdc90 `_\ ), closes `#203 `_