--- /dev/null
+New Feature: Web-Based Patron Self-Registration
+===============================================
+
+Feature Summary
+---------------
+
+Patrons may now fill out a web-based form from within the TPAC to create
+pending user accounts. The goal is to make the registration process more
+efficient by allowing the patron to provide much of the registration
+details in advance of registering with staff. Pending user accounts have
+no privileges.
+
+The form supports showing fields, requiring fields, applying format
+validation, and display example text for select fields by inspecting the
+'ui.patron.edit.*.show', 'ui.patron.edit.*.require', 'ui.patron.edit.*.regex',
+and 'ui.patron.edit.*.example' org unit settings respectively. The org unit
+settings to inspect are loaded dynamically, so any similar org unit settings
+added in the future will also be honored.
+
+Pending patron accounts which sit unattended in the database for too long
+are purged via a regularly running (CRON) script.
+
+Technical Details
+-----------------
+
+ * To activate the web form and allow pending patrons to be created, set
+ the 'opac.allow_pending_user' org unit setting to true where appropriate.
+ * Once activated, a link to the web form will appear as the second default
+ "bottom link" in the TPAC, just after the "Dynamic Catalog" link.
+ * To purge old pending user accounts, set an interval value for the new
+ 'opac.pending_user_expire_interval' org unit setting.
+
+Upgrade Notes
+-------------
+
+ * If a value is set for the 'opac.pending_user_expire_interval' for
+ any org units, the new /openils/bin/purge_pending_users.srfsh script
+ should also be added the opensrf user's crontab. Running the script once
+ per day should suffice.