[SDK-163: Added descriptions to plugin READMEs, tidying up

Author: echarrod

README.md

@@ -22,8 +22,8 @@ How to install the SDK to your project
 6) [Configuration](#configuration)-
 Entry point explanation
 
-7) [Profile Retrieval](#profile-retrieval)-
-How to retrieve a Yoti profile using the token
+7) [Handling Users](#handling-users)-
+How to manage users
 
 8) [Running the examples](#running-the-examples)-
 How to retrieve a Yoti profile using the token
@@ -37,12 +37,12 @@ Attributes defined
 11) [Running the tests](running-the-tests)-
 Running tests for SDK example
 
-12) [Support](#support)-
-Please feel free to reach out
-
-13) [Version Support](version-support) -
+12) [Version Support](version-support) -
 Extra information on ensuring correct version of Python is being used
 
+13) [Support](#support)-
+Please feel free to reach out
+
 ## An Architectural View
 
 Before you start your integration, here is a bit of background on how the integration works. To integrate your application with Yoti, your back-end must expose a GET endpoint that Yoti will use to forward tokens.
@@ -152,7 +152,7 @@ Both example applications utilise the env variables described in [Configuration]
 
 ### Plugins ###
 
-Plugins for both Django and Flask are in the `plugins/` dir. Their purpose is to make it as easy as possible to use the Yoti SDK with those frameworks. See their respective `README` files for details.
+Plugins for both Django and Flask are in the `plugins/` dir. Their purpose is to make it as easy as possible to use the Yoti SDK with those frameworks. See the [Django](/plugins/django_yoti/README.md) and [Flask](/plugins/flask_yoti/README.mdl) README files for further details.
 
 ## Running the Tests
 

plugins/django_yoti/README.md

@@ -1,6 +1,6 @@
 # Django Yoti #
 
-Description
+Instructions for configuring your Django project to integrate with Yoti.
 
 ## Plugin configuration ##
 ### General settings ###
@@ -21,7 +21,7 @@ INSTALLED_APPS = [
     - `yoti_application_id`
     - `yoti_login_button_*`
 
-* If you're using django template backend that supports context processors
+* If you're using a Django template backend that supports context processors
 like default DTL (Django Template Language) and want to use context tags
 inside your template (e.g. `{{ yoti_login_button_*}}`), then you should
 include `django_yoti`'s context processors into your templates
@@ -43,7 +43,7 @@ TEMPLATES = [
     },
 ]
 ```
-* Otherwise you'll have to pass yoti context to your templates manually:
+* Otherwise you'll have to pass Yoti context to your templates manually:
 ```python
 from django_yoti import yoti_context
 
@@ -94,7 +94,7 @@ urlpatterns = [
     url(r'^profile/', views.profile, name='yoti_profile')
 ]
 ```
-`yoti_auth` url is used for receiving token via callback and should'nt be changed.<br>
+`yoti_auth` URL is used for receiving token via callback and shouldn't be changed.<br>
 The last two URLs are examples and can be overridden by the following settings:
 
 ```python
@@ -188,9 +188,9 @@ def profile_view(request):
 ```
 <br>
 
-To make `yoti_authenticated` decorator work with django class based
+To make `yoti_authenticated` decorator work with Django class based
 views as well as with classic method based views, you can use it while
-declaring your project's urls:
+declaring your project's URLs:
 ```python
 # your_django_project/urls.py
 from django_yoti import yoti_authenticated

plugins/flask_yoti/README.md

@@ -1,5 +1,7 @@
 # Flask Yoti #
 
+Instructions for configuring your Flask project to integrate with Yoti.
+
 ## Plugin configuration ##
 ### General settings ###
 
@@ -120,7 +122,7 @@ button in order for it to work. See: [Yoti Developers Documentation](https://www
 
 2. After successful authentication, user will be redirected to a view,
 provided by the `YOTI_REDIRECT_TO` setting.
-3. In order to have an access to an authenticated user's information inside a view,
+3. In order to get access to an authenticated user's information inside a view,
 you should use a `@yoti_authenticated` decorator.
 Example:
 ```python