trailing whitespace and expand

docs/documentation.md

-# Writing Documentation 
+# Writing Documentation
 
-[CiviCRM.org/documentation](https://civicrm.org/documentation) has a nice high-level list of all active documentation. 
+[CiviCRM.org/documentation](https://civicrm.org/documentation) has a nice high-level list of all active documentation.
 
-## Guides in mkdocs 
+## Guides in mkdocs
 
-We are using [mkdocs](http://www.mkdocs.org) to produce guides, and currently have the following two: 
+We are using [mkdocs](http://www.mkdocs.org) to produce guides, and currently have the following two:
 
 * [User Guide](https://docs.civicrm.org/user/en/stable/)
-* [Developer Guide](https://docs.civicrm.org/dev/en/master/) *(which you are reading now!)* 
+* [Developer Guide](https://docs.civicrm.org/dev/en/master/) *(which you are reading now!)*
 
-The content for each of these guides is written in markdown, stored in text files, and hosted on GitHub. 
+The content for each of these guides is written in markdown, stored in text files, and hosted on GitHub.
 
-### How to edit 
+### How to edit
+
+For minor changes you can simply edit the markdown online using GitHub. However, for a better editing experience we highly recommend installing `mkdocs`:
 
 1.  Obtain the source files for the guide you want to edit
     1. Find the repository on GitHub (e.g. here is [the repo for this guide](https://github.com/civicrm/civicrm-dev-docs))
     1. Fork and clone locally. (For more help with Git and GitHub see [Git](git))
 1.  Install mkdocs on your machine.
-    1.  For Ubuntu 
-        
+    1.  For Ubuntu
+
             sudo apt-get install python-pip python-wheel
             sudo pip install mkdocs
 
     1.  For other platforms, follow instructions on [mkdocs.org](http://www.mkdocs.org)
 
-1. Launch a local copy of the guide 
-    1. Run: 
+1. Launch a local copy of the guide
+    1. Run:
 
             cd civicrm-dev-docs
             mkdocs serve
-    
-        * If you get `[Errno 98] Address already in use` then try something like 
-        
-        `mkdocs serve -a localhost:8001` 
-    
+
+        * If you get `[Errno 98] Address already in use` then try using a different port
+        with `mkdocs serve -a localhost:8001`
+
     1. Go to `http://localhost:8000` to view
-    
-1. Edit, commit, push, submit pull request 
-   
 
-### Formatting 
+1. Edit the [markdown](markdownrules) with an editor of your choice. As you save your changes `mkdocs` will automatically reprocess the page and refresh your browser.
+
+1. When you are happy with your edits use git to commit and push your chnanges then submit a  pull request on GitHub.
+
+
+### Formatting
 
-See [Markdown](markdownrules) for formatting syntax within mkdocs. 
+See [Markdown](markdownrules) for formatting syntax within mkdocs.
 
 
-## Documentation in the wiki 
+## Documentation in the wiki
 
-The [CiviCRM wiki](https://wiki.civicrm.org/confluence/display/CRMDOC/CiviCRM+Documentation) has lots of great info but is slowly falling out of use in favor of mkdocs. 
+The [CiviCRM wiki](https://wiki.civicrm.org/confluence/display/CRMDOC/CiviCRM+Documentation) has lots of great info but is slowly falling out of use in favor of mkdocs.