diff --git a/docs/index.md b/docs/index.md
index 82b9629fc..689064749 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -56,9 +56,9 @@ To find out more about GOV.UK Notify, see the [Government as a Platform](https:/
 
 There are 2 ways to integrate the API into your service:
 
-* use one of the client libraries provided by GOV.UK Notify (see the Usage section in the Readme files):
-      * [Python library](https://github.com/alphagov/notifications-python-client/blob/master/README.md#usage)
-      * [PHP library](https://github.com/alphagov/notifications-php-client/blob/master/README.md#usage)
+* use one of the client libraries provided by GOV.UK Notify:
+      * Python library - [link to coding examples](https://github.com/alphagov/notifications-python-client/blob/master/README.md#usage)
+      * PHP library [link to coding examples](https://github.com/alphagov/notifications-php-client/blob/master/README.md#usage)
       * [Java library](https://github.com/alphagov/notifications-java-client)
 * develop your own integration to produce requests in the correct format