DOC: Adding more documentation changes
- Added changes based on suggestions made after !2958 (merged)
- Added missing note on calling methods with in a class
- Added missing note on global variables
- Updated develop.md to point to the style information and added a section on reformatting a merge request.