📚 Updates all documentation

CODE_OF_CONDUCT.md

@@ -22,11 +22,14 @@ include:
 
 Examples of unacceptable behavior by participants include:
 
-- The use of sexualized language or imagery and unwelcome sexual attention or advances
+- The use of sexualized language or imagery and unwelcome sexual attention
+  or advances
 - Trolling, insulting/derogatory comments, and personal or political attacks
 - Public or private harassment
-- Publishing others' private information, such as a physical or electronic address, without explicit permission
+- Publishing others' private information, such as a physical or
-- Other conduct which could reasonably be considered inappropriate in a professional setting
+  electronic address, without explicit permission
+- Other conduct which could reasonably be considered inappropriate
+  in a professional setting
 
 ## Our responsibilities
 
@@ -52,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project lead at frenck@geekchimp.com. All
+reported by contacting the project lead at frenck@addons.community. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project lead is
 obligated to maintain confidentiality with regard to the reporter of an incident.

CONTRIBUTING.md

@@ -21,9 +21,9 @@ Even better: You could submit a pull request with a fix / new feature!
 1. Search our repository for open or closed [pull requests][prs] that relates
    to your submission. You don't want to duplicate effort.
 
-2. You may merge the pull request in once you have the sign-off of two other
+1. You may merge the pull request in once you have the sign-off of two other
    developers, or if you do not have permission to do that, you may request
    the second reviewer to merge it for you.
 
-[github]: https://github.com/hassio-addons/repository/issues
+[github]: https://github.com/hassio-addons/repositoru/issues
 [prs]: https://github.com/hassio-addons/repository/pulls

README.md

@@ -5,6 +5,18 @@
 ![Awesome][awesome-shield]
 [![License][license-shield]](LICENSE.md)
 
+[![Code Climate][codeclimate-shield]][codeclimate]
+[![Bountysource][bountysource-shield]][bountysource]
+[![Discord][discord-shield]][discord]
+[![Community Forum][forum-shield]][forum]
+
+[![Gratipay][gratipay-shield]][gratipay]
+[![Patreon][patreon-shield]][patreon]
+[![PayPal][paypal-shield]][paypal]
+[![Bitcoin][bitcoin-shield]][bitcoin]
+
+## About
+
 Hass.io allows anyone to create add-on repositories to share their add-ons for
 Hass.io easily. This repository is one of those repositories, providing extra
 Home Assistant add-ons for your Hass.io installation.
@@ -25,6 +37,20 @@ https://github.com/hassio-addons/repository
 
 ## Add-ons provided by this repository
 
+### ✓ [Example][addon-example]
+
+![Latest Version][example-version-shield]
+![Supports armhf Architecture][example-armhf-shield]
+![Supports aarch64 Architecture][example-aarch64-shield]
+![Supports amd64 Architecture][example-amd64-shield]
+![Supports i386 Architecture][example-i386-shield]
+![Docker Pulls][example-pulls-shield]
+
+This is our example add-on that shows a different approach to Hass.io add-on
+development. It shows a random quote in the log every couple of seconds.
+
+[:books: Example add-on documentation][addon-example]
+
 ### ✓ [Homebridge][addon-homebridge]
 
 ![Latest Version][homebridge-version-shield]
@@ -64,15 +90,22 @@ focusses on security, usability, and flexibility.
 ![Docker Pulls][terminal-pulls-shield]
 
 This add-on allows you to log in to your Hass.io Home Assistant instance using
-a web terminal. It is like SSH but in your Home Assistant frontend.
+a web terminal. It is like SSH but on your Home Assistant frontend.
 
 [:books: Terminal add-on documentation][addon-terminal]
 
-## Changelog
+## Changelog & releases
 
 This add-on repository itself does not keep a change log, the individual
-add-ons, however, do. The format is based on [Keep a Changelog][keepchangelog]
+add-ons, however, do. The format is based on [Keep a Changelog][keepchangelog].
-moreover, these add-ons adhere to [Semantic Versioning][semver].
+
+Add-on releases are based on [Semantic Versioning][semver], and use the format
+of ``MAJOR.MINOR.PATCH``. In a nutshell, the version will be incremented
+based on the following:
+
+- ``MAJOR``: Incompatible or major changes.
+- ``MINOR``: Backwards-compatible new features and enhancements.
+- ``PATCH``: Backwards-compatible bugfixes and package updates.
 
 ## Support
 
@@ -80,8 +113,8 @@ Got questions?
 
 You have several options to get them answered:
 
-- The Home Assistant [Community Forums][forums], we have a 
+- The Home Assistant [Community Forum][forum], we have a
-  [dedicated topic][forums] on that forum regarding this repository.
+  [dedicated topic][forum] on that forum regarding this repository.
 - The Home Assistant [Discord Chat Server][discord] for general Home Assistant
   discussions and questions.
 - Join the [Reddit subreddit][reddit] in [/r/homeassistant][reddit]
@@ -90,23 +123,23 @@ You could also open an issue here on GitHub. Note, we use a separate
 GitHub repository for each add-on. Please ensure you are creating the issue
 on the correct GitHub repository matching the add-on.
 
+- [Open an issue for the addon: Example][example-issue]
 - [Open an issue for the addon: Homebridge][homebridge-issue]
 - [Open an issue for the addon: SSH - Secure Shell][ssh-issue]
 - [Open an issue for the addon: Terminal][terminal-issue]
-- For a general repository issues or add-on ideas [open a issue here][issue]
+
+For a general repository issues or add-on ideas [open an issue here][issue]
 
 ## Contributing
 
 This is an active open-source project. We are always open to people who want to
 use the code or contribute to it.
 
-We've set up a separate document for our [contribution guidelines](CONTRIBUTING.md).
+We have set up a separate document containing our
+[contribution guidelines](CONTRIBUTING.md).
 
 Thank you for being involved! :heart_eyes:
 
-We are also looking for maintainers!  
-Please send [Franck Nijhof][frenck] a message when you are interested in becoming one.
-
 ## Authors & contributors
 
 The original setup of this repository is by [Franck Nijhof][frenck].
@@ -138,15 +171,32 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
-[issue]: https://github.com/hassio-addons/repository/issues
+[addon-example]: https://github.com/hassio-addons/addon-example
 [addon-homebridge]: https://github.com/hassio-addons/addon-homebridge
 [addon-ssh]: https://github.com/hassio-addons/addon-ssh
 [addon-terminal]: https://github.com/hassio-addons/addon-terminal
 [awesome-shield]: https://img.shields.io/badge/awesome%3F-yes-brightgreen.svg
+[bitcoin-shield]: https://img.shields.io/badge/donate-bitcoin-blue.svg
+[bitcoin]: https://blockchain.info/payment_request?address=3GVzgN6NpVtfXnyg5dQnaujtqVTEDBCtAH
+[bountysource-shield]: https://img.shields.io/bountysource/team/hassio-addons/activity.svg
+[bountysource]: https://www.bountysource.com/teams/hassio-addons/issues
+[codeclimate-shield]: https://img.shields.io/badge/code%20climate-protected-brightgreen.svg
+[codeclimate]: https://codeclimate.com/github/hassio-addons/repository
 [contributors]: https://github.com/hassio-addons/repository/graphs/contributors
+[discord-shield]: https://img.shields.io/discord/330944238910963714.svg
 [discord]: https://discord.gg/c5DvZ4e
-[forums]: https://community.home-assistant.io/t/repository-community-hass-io-add-ons/24705?u=frenck
+[example-aarch64-shield]: https://img.shields.io/badge/aarch64-yes-green.svg
-[frenck]: https://community.home-assistant.io/u/frenck/summary
+[example-amd64-shield]: https://img.shields.io/badge/amd64-yes-green.svg
+[example-armhf-shield]: https://img.shields.io/badge/armhf-yes-green.svg
+[example-i386-shield]: https://img.shields.io/badge/i386-yes-green.svg
+[example-issue]: https://github.com/hassio-addons/addon-example/issues
+[example-pulls-shield]: https://img.shields.io/docker/pulls/hassioaddons/example-armhf.svg
+[example-version-shield]: https://images.microbadger.com/badges/version/hassioaddons/example-armhf.svg
+[forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg
+[forum]: https://community.home-assistant.io/t/repository-community-hass-io-add-ons/24705?u=frenck
+[frenck]: https://github.com/frenck
+[gratipay-shield]: https://img.shields.io/badge/donate-gratipay-blue.svg
+[gratipay]: https://gratipay.com/hassio-addons/
 [homebridge-aarch64-shield]: https://img.shields.io/badge/aarch64-yes-green.svg
 [homebridge-amd64-shield]: https://img.shields.io/badge/amd64-yes-green.svg
 [homebridge-armhf-shield]: https://img.shields.io/badge/armhf-yes-green.svg
@@ -154,10 +204,16 @@ SOFTWARE.
 [homebridge-issue]: https://github.com/hassio-addons/addon-homebridge/issues
 [homebridge-pulls-shield]: https://img.shields.io/docker/pulls/hassioaddons/homebridge-armhf.svg
 [homebridge-version-shield]: https://images.microbadger.com/badges/version/hassioaddons/homebridge-armhf.svg
+[issue]: https://github.com/hassio-addons/repository/issues
 [keepchangelog]: http://keepachangelog.com/en/1.0.0/
 [license-shield]: https://img.shields.io/github/license/hassio-addons/repository.svg
 [maintenance-shield]: https://img.shields.io/maintenance/yes/2017.svg
-[project-stage-shield]: https://img.shields.io/badge/Project%20Stage-Development-yellowgreen.svg
+[patreon-shield]: https://img.shields.io/badge/donate-patreon-blue.svg
+[patreon]: https://www.patreon.com/frenck
+[paypal-shield]: https://img.shields.io/badge/donate-paypal-blue.svg
+[paypal]: https://www.paypal.me/FranckNijhof
+[project-stage-shield]: https://img.shields.io/badge/project%20stage-production%20ready-brightgreen.svg
+[reddit]: https://reddit.com/r/homeassistant
 [reddit]: https://reddit.com/r/homeassistant
 [semver]: http://semver.org/spec/v2.0.0.html
 [ssh-aarch64-shield]: https://img.shields.io/badge/aarch64-yes-green.svg

example/README.md

@@ -1,7 +1,7 @@
-# Community Hass.io Add-on: Example
+# Community Hass.io Add-ons: Example
 
 This is just a configuration stub to make the Hass.io repository work.
 
 The add-on itself can be found at the following URL:
 
-https://github.com/hassio-addons/addon-example
+<https://github.com/hassio-addons/addon-example>

homebridge/README.md

@@ -1,7 +1,7 @@
-# Community Hass.io Add-on: Homebridge
+# Community Hass.io Add-ons: Homebridge
 
 This is just a configuration stub to make the Hass.io repository work.
 
 The add-on itself can be found at the following URL:
 
-https://github.com/hassio-addons/addon-homebridge
+<https://github.com/hassio-addons/addon-homebridge>

ssh/README.md

@@ -1,7 +1,7 @@
-# Community Hass.io Add-on: SSH - Secure Shell
+# Community Hass.io Add-ons: SSH - Secure Shell
 
 This is just a configuration stub to make the Hass.io repository work.
 
 The add-on itself can be found at the following URL:
 
-https://github.com/hassio-addons/addon-ssh
+<https://github.com/hassio-addons/addon-ssh>

terminal/README.md

@@ -1,7 +1,7 @@
-# Community Hass.io Add-on: Terminal
+# Community Hass.io Add-ons: Terminal
 
 This is just a configuration stub to make the Hass.io repository work.
 
 The add-on itself can be found at the following URL:
 
-https://github.com/hassio-addons/addon-terminal
+<https://github.com/hassio-addons/addon-terminal>