Implement docs suggestions

Author: MGatner

README.md

@@ -85,28 +85,31 @@ service('setting')->forget('App.siteName')
 In addition to the default behavior describe above, `Settings` can can be used to define "contextual settings".
 A context may be anything you want, but common examples are a runtime environment or an authenticated user.
 In order to use a context you pass it as an additional parameter to the `get()`/`set()`/`forget()` methods; if
-a context setting is requested and does not exist then the default global value will be used.
+a context setting is requested and does not exist then the general value will be used.
 
 Contexts may be any unique string you choose, but a recommended format for supplying some consistency is to
-given them a category and identifier, like `environment:production` or `group:42`.
+give them a category and identifier, like `environment:production` or `group:42`.
 
 An example... Say your App config includes the name of a theme to use to enhance your display. By default
 your config file specifies `App.theme = 'default'`. When a user changes their theme, you do not want this to
 change the theme for all visitors to the site, so you need to provide the user as the *context* for the change:
 
 ```php
-	$context = 'user:' . user_id();
-	service('setting')->set('App.theme', 'dark', $context);
+$context = 'user:' . user_id();
+service('setting')->set('App.theme', 'dark', $context);
 ```
 
 Now when your filter is determining which theme to apply it can check for the current user as the context:
 
 ```php
-	$context = 'user:' . user_id();
-	$theme = service('setting')->get('App.theme', $context);
+$context = 'user:' . user_id();
+$theme = service('setting')->get('App.theme', $context);
+
+// or using the helper
+setting()->get('App.theme', $context);
 ```
 
-If that context is not found the library falls back to the global value, i.e. `service('setting')->get('App.theme')`
+If that context is not found the library falls back to the general value, i.e. `service('setting')->get('App.theme')`
 
 ### Using the Helper
 

UPGRADING.md

@@ -0,0 +1,6 @@
+# Upgrade Guide
+
+## Version 1 to 2
+***
+
+* Due to the addition of contexts the `BaseHandler` abstract class was changed. Update any handlers that extend this class to include the new and changed methods.