Update changelog to note new logo setting, and add some documentation…

… for Opal settings.

CHANGELOG.md

@@ -19,6 +19,12 @@ Adds a utility method to the `Episode` service that returns a human readable pat
 
 Enhances the API available for plugins to include javascript and css by adding methods on `opal.core.plugins.OpalPlugin`
 
+#### OPAL_LOGO_PATH
+
+This new setting allows applications to set the path at which the app logo is served.
+If `OPAL_LOGO_PATH` is set, the value is passed to the `{% static %}` templatetag to set the `src` atribute
+of an image in the default application header and login screen.
+
 ### 0.8.1 (Minor Release)
 
 #### Cookies for the future

doc/docs/opaldocs.css

@@ -20,7 +20,7 @@ h1 {
     margin-bottom: 24px;
 }
 h2 {
-    font-size: 36px;
+    font-size: 30px;
 }
 h3 {
     font-size: 24px;

doc/docs/reference/reference_guides.md

@@ -53,7 +53,8 @@ The following reference guides are available:
 
 |
 -|-
+[Settings](settings.md) | Opal settings
 [Changelog](changelog.md) | Opal Changelog
-[Upgrading](upgrading.md) | Upgrading between Opal> versions
+[Upgrading](upgrading.md) | Upgrading between Opal versions
 [Javascript dependencies](javascript/javascript_dependencies.md)| External javascript libraries available |
 [Testing](testing.md) | Testing

doc/docs/reference/settings.md

@@ -0,0 +1,24 @@
+# Opal Settings
+
+Opal applications provide a number of settings in the `settings.py` of your application.
+
+## OPAL_BRAND_NAME
+
+The human readable form of your application name.
+Displayed in the header by default.
+Scaffolded applications start with whatever is passed in to `opal startproject`.
+
+## OPAL_LOG_OUT_DURATION
+
+Opal will log users out if they have been inactive for greater than this value.
+Scaffolded applications set this to 15 minutes by default. Unit is milliseconds.
+
+## OPAL_LOGO_PATH
+
+If `OPAL_LOGO_PATH` is set, the value is passed to the `{% static %}` templatetag to set the
+`src` atribute of an image in the default application header and login screen.
+
+## VERSION_NUMBER
+
+The version number of your application. Displayed in the header by default.
+Scaffolded applications start at `<0.0.1`.

doc/mkdocs.yml

@@ -68,6 +68,7 @@ pages:
       - Detail Views: reference/detail_views.md
       - Patient Lists: reference/patient_list.md
       # Misc
+      - Settings: reference/settings.md
       - Changelog: reference/changelog.md
       - Testing: reference/testing.md
       - Upgrading: reference/upgrading.md