X-Git-Url: http://sru.miketaylor.org.uk/?a=blobdiff_plain;f=doc%2Flibrary-configuration.txt;h=311c3b0bd16cdc844a784dfa3f707f4b02193aeb;hb=8871d5d24f00a1ec36b58334b703701b3c9183fa;hp=99581080ea3f14c347030821f4c5e24cf376cc62;hpb=d18748b6100261af48412752d4ada866096f1a4d;p=mkws-moved-to-github.git

diff --git a/doc/library-configuration.txt b/doc/library-configuration.txt
index 9958108..311c3b0 100644
--- a/doc/library-configuration.txt
+++ b/doc/library-configuration.txt
@@ -2,17 +2,24 @@ MKWS Target Selection
 =====================
 
 
-MKWS accesses targets using the Pazpar2 metasearching engine, almost
-always fronted by the Service Proxy to manage target selection. This
-document assumes the SP is used, and so that a library of targets is
-available, maintained using an instance of MKAdmin (often
-http://mkc-admin.indexdata.com/console/)
+MKWS accesses targets using the Pazpar2 metasearching engine. Although
+Pazpar2 can be used directly, using a statically configured set of
+targets, this usage is unusual. More often, Pazpar2 is fronted by the
+Service Proxy (SP), which manages authentication, sessions, target
+selection, etc.
+
+This document assumes the SP is used, and explains how to go about
+making a set of targets (a "library") available, how to connect your
+MKWS application to that library, and how to choose which of the
+available targets to use.
 
 
 1. Maintaining the library
 --------------------------
 
-###
+### and so that a library of targets
+is available, maintained using an instance of MKAdmin (often
+http://mkc-admin.indexdata.com/console/)
 
 
 2. Choosing targets from the library