Docs: add admin docs for multiple holds feature

Signed-off-by: Jane Sandberg <sandbej@linnbenton.edu>

diff --git a/docs/modules/local_admin/nav.adoc b/docs/modules/local_admin/nav.adoc
index a6398da..83df2f2 100644 (file)
--- a/docs/modules/local_admin/nav.adoc
+++ b/docs/modules/local_admin/nav.adoc
@@ -5,6 +5,7 @@
 ** xref:admin:emergency_closing_handler.adoc[Emergency Closing Handler]
 ** xref:admin:hold_driven_recalls.adoc[Hold-driven recalls]
 ** xref:admin:hold_groups_admin.adoc[Hold Groups Administration]
+** xref:local_admin:multiple_holds_admin.adoc[Placing Multiple Holds]
 ** xref:admin:actiontriggers.adoc[Notifications / Action Triggers]
 *** xref:admin:actiontriggers_process.adoc[Processing Action Triggers]
 ** xref:local_admin:negative_balances.adoc[Patron with Negative Balances]

diff --git a/docs/modules/local_admin/pages/multiple_holds_admin.adoc b/docs/modules/local_admin/pages/multiple_holds_admin.adoc
new file mode 100644 (file)
index 0000000..52b8fd8
--- /dev/null
+++ b/docs/modules/local_admin/pages/multiple_holds_admin.adoc
@@ -0,0 +1,44 @@
+[[multiple_holds_admin]]
+= Placing Multiple Holds
+::toc::
+
+indexterm:[holds,placing multiple]
+
+You can allow some or all of your patrons to place multiple holds at
+once.
+
+.Use case
+****
+This feature is especially beneficial for book clubs and reading groups,
+which need to place holds on multiple copies of a title.
+****
+
+Users with the appropriate permissions now have the ability to place multiple title/metarecords holds at once. 
+
+In order to use the feature:
+
+. Go to *Administration -> Local Administration -> Library Settings Editor*.
+. Set the Maximum number of duplicate holds allowed Library Setting
+(_circ.holds.max_duplicate_holds_) to a number higher than 1.
+. Go to *Administration -> User Permission Editor* to give the _CREATE_DUPLICATE_HOLDS_
+permission to the users that need it.
+
+When placing a title or metarecord hold, a Number of copies field will display for
+these users. This field is not available when placing part, volume or copy holds.
+
+[TIP]
+====
+You can also add the _CREATE_DUPLICATE_HOLDS_ permission to a permission
+group in *Administration -> Server Administration -> Permission Group*.
+For example, you could create a new patron group called "Book club leaders".
+====
+
+[TIP]
+====
+If you are only applying this to certain patrons on an ad-hoc basis,
+make sure that all circulation workers who might need to grant this
+permission to a patron have the permission to grant it.
+====
+
+This feature does not change the way in which the system fills holds. The multiple holds will fill in the same way that they would if the user had placed multiple holds separately.
+