rearrange and better document config file

_config.yml

@@ -1,4 +1,4 @@
-# --- Basic general options --- #
+# --- Basic options --- #
 
 # Name of website
 title: My website
@@ -9,7 +9,17 @@ description: A virtual proof that I'm awesome
 # Your name to show in the footer
 author: Some Person
 
+# --- List of links in the navigation bar --- #
+
+navbar-links:
+  About Me: "aboutme"
+  Resources:
+    - Beautiful Jekyll: "http://deanattali.com/beautiful-jekyll/"
+    - Learn markdown: "http://www.markdowntutorial.com/"
+  Author's home: "http://deanattali.com"
+
 # --- Local development options ---
+
 # If your website is hosted locally rather than on GitHub, then you need to uncomment the next two parameters to set the url and baseurl
 # ***If you're not sure what this mean, then leave this section as it is. Only modify the url and baseurl if you know what you're doing!***
 
@@ -19,15 +29,7 @@ author: Some Person
 # baseurl should be an empty string
 #baseurl: ""
 
-# --- Navigation bar options --- #
-
-# List of links in the navigation bar
-navbar-links:
-  About Me: "aboutme"
-  Resources:
-    - Beautiful Jekyll: "http://deanattali.com/beautiful-jekyll/"
-    - Learn markdown: "http://www.markdowntutorial.com/"
-  Author's home: "http://deanattali.com"
+# --- Logo --- #
 
 # Image to show in the navigation bar - works best with a square image
 # Remove this parameter if you don't want an image in the navbar
@@ -40,6 +42,7 @@ round-avatar: true
 # then specify the following parameter
 #title-img: /path/to/image
 
+
 # --- Footer options --- #
 
 # Select your active Social Network links.
@@ -64,7 +67,7 @@ social-network-links:
 #  twitch: yourname
 #  yelp: yourname
 
-# --- More general options --- #
+# --- General options --- #
 
 # Select which social network share links to show in posts
 share-links-active:
@@ -82,7 +85,7 @@ link-tags: true
 # Excerpt Word Length - Truncates the excerpt to the specified number of words on the index page
 excerpt_length: 50
 
-# --- Background colour/image options --- #
+# --- Colours / background image --- #
 
 # Personalize the colors in your website. Colour values can be any valid CSS colour
 
@@ -130,7 +133,7 @@ footer-link-col: "#404040"
 # To use Facebook Comments, fill in a Facebook App ID
 #fb_comment_id: ""
 
-# To use Staticman comments, fill in repository, branch, and endpoint
+# To use Staticman comments, fill in "repository", "branch", and "endpoint"
 staticman:
   repository : # GitHub username/repository eg. "daattali/beautiful-jekyll"
   branch     : master # If you're not using `master` branch, then you also need to update the `branch` parameter in `staticman.yml`
@@ -141,7 +144,7 @@ staticman:
     siteKey  : # Use your own site key, you need to apply for one on Google
     secret   : # ENCRYPT your password by going to https://staticman3.herokuapp.com/v3/encrypt/<your-site-secret>
 
-# To use Utterances comments: (1) fill in repository (make sure the repository is public), (2) Enable Issues in your repository, 
+# To use Utterances comments: (1) fill in "repository" (make sure the repository is public), (2) Enable Issues in your repository,
 # (3) Install the Utterances app in your repository https://github.com/apps/utterances
 # See more details about the parameters below at https://utteranc.es/
 utterances:
@@ -163,6 +166,7 @@ date_format: "%B %-d, %Y"
 # Facebook App ID
 #fb_app_id: ""
 
+
 # --- You don't need to touch anything below here (but you can if you want) --- #
 
 # Output options (more information on Jekyll's site)