Adds beginning of general section on indentation and commenting code d…

…wyl/summer#22 dwyl/definition-of-done#3

README.md

@@ -9,11 +9,58 @@ For now, the **visual** and **coding styles** [will live in the _same repo_](htt
 
 ##Contents Guide
 + [Why?](#why)
-
++ [General guidelines](#general)
+  + [ ] [Indentation](#indentation)
+  + [ ] [Commenting your code](#commenting-your-code)
++ [ ] [Git](#)
+  + [ ] [Writing issues](#)
+  + [ ] [Commit messages](#)
+  + [ ] [Pull requests](#)
++ [ ] [Markdown](#)
++ [ ] [CSS](#)
+
 
 ##Why?
 **Consistency**.    
 
 Every developer likes to do things their own way.    
 Even though we have our own idea of what maintainable code looks like, _the important thing isn't how many spaces we indent our code with_ but that **everything is consistent** so new people _don't have to work through personal formatting quirks_ of previous developers and can **focus on the code**.
+<br/>
+<br/>
+
+##General
+
+###Indentation
+**2 space indentation**.    
+You can usually set this up in the _Preferences_ of your favourite text editor so you never have to think about it again (example below on [Atom editor](https://atom.io/)).
+
+<img width="507" alt="atom-soft-tab-preferences-menu" src="https://cloud.githubusercontent.com/assets/4185328/9154618/a6598690-3e91-11e5-939b-2c03cf3c7ffc.png">
+
+###Intelligently commenting your code
+We favour the _intelligent approach_.
+
+Many developers (not us) believe that [well-written code doesn't need comments](http://sublimecoding.com/blog/2015/01/12/dont-comment-your-code-rewrite-it).
+Whilst it's true that **adding too many comments to your code makes it unreadable**. The key is to **put yourself in the shoes of the next person who has to work with your code**. 
+
+If you feel **your code is as simple as it can be** but what it doesn't isn't immediately obvious, then add a comment.    
+Good examples of this are when something in your code in one location necessarily has an impact elsewhere.
+
+```javascript
+//JavaScript example
+else {
+  mod = moduleName.replace('.js', '.\.js'); //escape .js for regex
+}
+```
+
+```css
+/*CSS example*/
+.article {
+  position: relative; /*contains `.quote` which is positioned absolutely*/
+  ...
+}
+```
+
+
+https://github.com/dwyl/summer-2015/issues/22
+