making it more clear how to perform local installs

diff --git a/README.md b/README.md
index 9f65fb25c1ff4006404373bf0acf14b702ee5421..7dca30c4cf2822ab353f11e3c6a43d0213f9d57f 100644 (file)
--- a/README.md
+++ b/README.md
@@ -74,16 +74,18 @@ to get SSL running on your server with Heroku.
 
 ## External Service Dependencies
 
-Notice: This software makes use of external third party services which require
+Notice: A number of services are required even if running the KarmaWorld web
+service [locally](#local). Some of the services are recommended, and some are
+completely optional even if running the web service on Heroku.
+
+This software makes use of external third party services which require
 accounts to access the service APIs. Without these third parties available,
-this software may require considerable overhaul. These services have
-API keys, credentials, and other information that you must provide to KarmaWorld
-as environment variables. The best way to persist these environment variables is
-by using a `.env` file.  Copy `.env.example` to `.env` and populate the fields as required.
-
-A number of services are required even if running the KarmaWorld web service
-locally, some of the services are recommended, and some are completely optional
-even if running the web service on Heroku.
+this software may require considerable overhaul. These services have API keys,
+credentials, and other information that you must provide to KarmaWorld
+as environment variables.
+
+The best way to persist these API keys in environment variables is by using a
+`.env` file.  Copy `.env.example` to `.env` and populate the fields as required.
 
 Many of these services have free tiers and can be used without charge for
 development testing purposes.