Improve documentation

Author: ehmicky

.github/ISSUE_TEMPLATE/bug_report.md

@@ -9,7 +9,8 @@ assignees: ''
 Thanks for reporting this bug!
 
 If this is related to a typo or the documentation being unclear, please click on
-the page's `Edit` button (pencil icon) and submit a correction instead.
+the relevant page's `Edit` button (pencil icon) and suggest a correction
+instead.
 
 Please search other issues to make sure this bug has not already been reported.
 
@@ -25,9 +26,8 @@ Step-by-step instructions on how to reproduce the behavior.
 
 Example:
 
-1. Use the default configuration.
-2. Type the following command: [...]
-3. etc.
+1. Type the following command: [...]
+2. etc.
 
 **Expected behavior**
 

.github/pull_request_template.md

@@ -1,11 +1,10 @@
 🎉 Thanks for sending this pull request! 🎉
 
-If you are fixing a typo or documentation, please skip these instructions.
+Please make sure the title is clear and descriptive.
 
-Otherwise please:
+If you are fixing a typo or documentation, please skip these instructions.
 
-- add a clear and descriptive title.
-- fill in the sections below.
+Otherwise please fill in the sections below.
 
 **Which problem is this pull request solving?**
 

CONTRIBUTING.md

@@ -2,13 +2,13 @@
 
 🎉 Thanks for considering contributing to this project! 🎉
 
-This document will help you send a pull request.
+These guidelines will help you send a pull request.
 
-If you're submitting an issue instead, you can skip this.
+If you're submitting an issue instead, please skip this document.
 
 If your pull request is related to a typo or the documentation being unclear,
-please click on the page's `Edit` button (pencil icon) and directly submit a
-correction instead.
+please click on the relevant page's `Edit` button (pencil icon) and directly
+suggest a correction instead.
 
 This project was made with ❤️. The simplest way to give back is by starring and
 sharing it online.
@@ -41,13 +41,16 @@ to learn how to use them. You don't need to know Gulp to use these tasks.
 
 # Requirements
 
+After submitting the pull request, please make sure the Continuous Integration
+checks are passing.
+
 We enforce 100% test coverage: each line of code must be tested.
 
-Documentation must be added for any new feature in all of these:
+New options, methods, properties, configuration and behavior must be documented
+in all of these:
 
 - the `README.md`
 - the `docs` directory (if any)
 - the `examples` directory (if any)
 
-After submitting the pull request, please make sure the Continuous Integration
-checks are passing.
+Please use the same style as the rest of the documentation and examples.

README.md

@@ -136,7 +136,7 @@ This project was made with ❤️. The simplest way to give back is by starring
 sharing it online.
 
 If the documentation is unclear or has a typo, please click on the page's `Edit`
-button (pencil icon) and submit a correction.
+button (pencil icon) and suggest a correction.
 
 If you would like to help us fix a bug or add a new feature, please check our
 [guidelines](CONTRIBUTING.md). Pull requests are welcome!