Contributing and about

docs/_sidebar.md

@@ -1,4 +1,4 @@
-- [![logo](_media/proxeus_logo.svg)](/)
+- [![logo](_media/proxeus_logo.svg)](https://proxeus.org)
 
 - Getting started
 

docs/about.md

@@ -1,13 +1,20 @@
-# The Proxeus Association
+# About the Proxeus Association
 
-The association is the governing body responsible for the maintenance and development of the Proxeus software. We also aim to encourage innovation and evangelize the project by launching and supporting community initiatives as well as creating synergies and partnerships with relevant community projects. The Association is working to give the project a decentralized structure (DAO) to allow our members to propose guidance on the software. We want to make the Proxeus software the WordPress of the blockchain and democratize the development of blockchain applications.
+The association is the governing body responsible for the maintenance and development of the Proxeus software. We also aim to encourage innovation and evangelize the project by launching and supporting community initiatives as well as creating synergies and partnerships with relevant community projects. 
 
-Please visit our [Community Forum](https://github.com/ProxeusApp/community/discussions) if you have any questions about the project, or write to us at [email protected]
+Governance
+----------
 
-Articles of association
------------------------
+The Association is working to give the project a decentralized structure to allow our members to propose guidance on the software. Our mission is to make the Proxeus software the 'WordPress' of the blockchain - in other words, to democratize access, and lower the costs of deployment of small blockchain applications.
 
-Proxeus Association is a non-profit association governed by the present statutes and, secondly, by Articles 60 et seq. of the Swiss Civil Code. It is politically neutral, and non- denominational.
+Some of the benefits of getting involved with the Association, is the ability to contribute both to day-to-day decisions and plans further out on the roadmap. The easiest way to do this now is to join us on [Open Collective](https://opencollective.com/proxeus).
+
+See also the [Contributing](contributing) section, and visit our [Community Forum](https://github.com/ProxeusApp/community/discussions) if you have any questions about the project - or write to us at [email protected]
+
+Statutes
+--------
+
+Proxeus Association is a non-profit association governed by the present statutes and, secondly, by Articles 60 et seq. of the Swiss Civil Code. It is politically neutral, and non-denominational.
 
 OVERVIEW
 --------

docs/contributing.md

@@ -1,18 +1,14 @@
 # Contributing
 
-First off, thank you `<3` for your interest in Proxeus: an open source project powered by a community of users and supporters like you.
+First off, thank you `<3` for your interest in Proxeus: an open source project powered by a community of users and supporters like you. We love to receive contributions from our community! There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, reporting bugs, requesting features, developing new nodes or writing core code for the Proxeus platform. 
 
-We love to receive contributions from our community! There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, reporting bugs, requesting features, developing new nodes or writing core code for the Proxeus platform. Following these guidelines indicates that you respect the time of the maintainers and fellow contributors of the project. In return, they should reciprocate that respect in addressing your issue, assessing changes, and helping you complete your pull requests.
+Following these guidelines indicates that you respect the time of the maintainers and fellow contributors of the project. In return, they should reciprocate that respect in addressing your issue, assessing changes, and helping you complete your pull requests.
 
-## Your First Contribution
-
-Unsure where to begin contributing to Proxeus? You can start by looking through the open [Github Issues](https://github.com/ProxeusApp/proxeus-core/issues). Some are labelled as "good first issue" if they're especially accessible to newcomers.
-
-See the [Coding Style](coding_style.md) section for instructions on the coding style we use. Some more tips are below in the Ground Rules and Getting Started below.
+See also [About the Proxeus Association](about) for some background.
 
 ### Community Discussion
 
-We have an open community discussion forum also on GitHub at https://github.com/ProxeusApp/community/discussions - this is a great place to share your use cases, any ideas for the platform, get feedback on work that you are doing. Please note the [GitHub Community Guidlines](https://docs.github.com/en/github/site-policy/github-community-guidelines) and our own ground rules in the [Code of Conduct (Contributor Covenant)](code_of_conduct.md).
+We have an open community discussion forum also on [GitHub Discussions](https://github.com/ProxeusApp/community/discussions) - this is a great place to share your use cases, any ideas for the platform, get feedback on work that you are doing. Please note the [GitHub Community Guidlines](https://docs.github.com/en/github/site-policy/github-community-guidelines) and our own ground rules in the [Code of Conduct](code_of_conduct.md) (Contributor Covenant).
 
 ### Reporting Issues
 Please use our [GitHub Issue Tracker](https://github.com/ProxeusApp/proxeus-core/issues) to open improvement and bug tickets.
@@ -21,18 +17,22 @@ If you find a **Security Issue** - a vulnerability that may affect live or testn
 
 ## Ground Rules
 
-* Be welcoming to newcomers and encourage diverse new contributors from all backgrounds. See our [Code of Conduct (Contributor Covenant)](code_of_conduct.md) for details.
+* Be welcoming to newcomers and encourage diverse new contributors from all backgrounds. See our [Code of Conduct](code_of_conduct.md) (Contributor Covenant) for details.
 * Create issues for any major changes and enhancements that you wish to make. Discuss things transparently and get community feedback.
 * Each pull request should implement ONE feature or bugfix. If you want to add or fix more than one thing, submit more than one pull request.
-* Do not commit changes to files that are irrelevant to your feature or bugfix (eg: .gitignore).
+* Do not commit changes to files that are irrelevant to your feature or bugfix (eg: `.gitignore`).
 * Take care that code in pull requests meets our coding guidelines. Be willing to accept criticism and work on improving your code; care must be taken not to introduce bugs.
 * Git commits are much more valued when they follow the git commit messages guide.
 * Be aware that the pull request review process is not immediate, and is generally proportional to the size of the pull request.
 * If your pull request is merged, please do not ask for an immediate release of a new version. There are many factors contributing to when releases occur. If necessary, please install from the GitLab source until the next official release.
 
-## Getting started
+## Making your first Contribution
+
+Unsure where to begin contributing to Proxeus? You can start by looking through the open [Github Issues](https://github.com/ProxeusApp/proxeus-core/issues). Some are labelled as "good first issue" if they're especially accessible to newcomers.
+
+See the [Coding Style](coding_style.md) section for instructions on the coding style we use. Some more tips are below in the Ground Rules and Getting Started below.
 
-1. Work on your own fork of the code rather than on a cloned repository. In order to fork a Github project go to https://github.com/ProxeusApp/proxeus-core then click on "Fork" and choose a suitable GitHub account for the fork —eg. your personal Github account. You only need to fork once per repository.
+1. Work on your own fork of the code rather than on a cloned repository. In order to fork a Github project go to [ProxeusApp/proxeus-core](https://github.com/ProxeusApp/proxeus-core) then click on "Fork" and choose a suitable GitHub account for the fork —eg. your personal Github account. You only need to fork once per repository.
 2. Announce you are on an issue. If you are trying to solve a reported issue, comment that you intend to solve it, and possibly discuss with the community and maintainers the best approach before starting to code.
 3. Create a new branch in your fork (be sure it is synchronized with the original project repository!) and name it after the issue from step #2. Code on that branch and commit your changes (it’s always good to add/fix tests).
 4. Open a pull request after having pushed your changes. Please, be sure to follow this git commit messages guide.