Merge 3.x into master

.github/PULL_REQUEST_TEMPLATE.md

@@ -17,7 +17,7 @@ I am targeting this branch, because {reason}.
     Remove it if this is not related.
 -->
 
-Closes #{put_issue_number_here}
+Closes #{put_issue_number_here}.
 
 ## Changelog
 
@@ -28,16 +28,16 @@ Closes #{put_issue_number_here}
     please keep it short and clear and to the point
 -->
 
-<!-- 
+<!--
     If you are updating something that doesn't require
-    a release, you can delete the whole Changelog section.
+    a release, you can delete the whole "Changelog" section.
     (eg. update to docs, tests)
 -->
 
 <!-- REMOVE EMPTY SECTIONS -->
 ```markdown
 ### Added
-- Added some `Class::newMethod` to do great stuff
+- Added some `Class::newMethod()` to do great stuff.
 
 ### Changed
 
@@ -51,13 +51,14 @@ Closes #{put_issue_number_here}
 ```
 
 <!--
-    If this is a work in progress, uncomment this section.
+    If this is a work in progress, uncomment the "To do" section.
     You can add as many tasks as you want.
     If some are not relevant, just remove them.
-    
-    ## To do
-    
-    - [ ] Update the tests
-    - [ ] Update the documentation
-    - [ ] Add an upgrade note
+-->
+<!--
+## To do
+
+- [ ] Update the tests;
+- [ ] Update the documentation;
+- [ ] Add an upgrade note.
 -->