Updates to documentation

Author: timsavage

docs/developers.rst

@@ -1,5 +1,5 @@
-Developers
-==========
+Contribution Guide
+==================
 
 We welcome contributions to the pyApp project (and sub projects).
 
@@ -16,8 +16,8 @@ met:
 
 - Update the docs with the details if required.
 
-- The API matters, ensure any features provide a nice API for end users.
-
+- The API matters, ensure any features provide a nice API for both developers and
+  end-users.
 
 The core pyApp package is intended to be light and mainly made up of plumbing
 code. If you want to add support for a particular service or server an extension

docs/extensions.rst

@@ -2,6 +2,9 @@
 Extensions
 ##########
 
+Extensions are features that are not part of the core pyApp framework but extend
+it's functionality.
+
 
 Available Extensions
 ====================

docs/getting-started.rst

@@ -5,8 +5,8 @@ Getting Started
 In this section we will run through the processes of building an application with
 ``pyApp``.
 
-App Layout
-==========
+Application Layout
+==================
 
 We'll start with a simple application that accepts input from the command line
 and combines it with a value from configuration.
@@ -45,9 +45,11 @@ uses this file to find information for the application.
 
 ``__version__``
     The version number of the application, it is recommended that this be a
-    semantic version. ``pyApp`` also provides tools for this to be fetched from
+    `semantic version`_. ``pyApp`` also provides tools for this to be fetched from
     the installed package list.
 
+.. _semantic version: https://semver.org/
+
 
 ``__main__.py``
 ---------------