diff --git a/AUTHORS.md b/AUTHORS.md
new file mode 100644
index 00000000..b25c7018
--- /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 00000000..4fb09c12
--- /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 6b8b06e2..e84c609a 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 00000000..bfcbf28c
--- /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 00000000..bb869794
--- /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 `_