Add documentation for search tools, a=chris

Chris Pollett [2014-06-27 18:Jun:th]
Add documentation for search tools, a=chris
Filename
en-US/pages/documentation.thtml
diff --git a/en-US/pages/documentation.thtml b/en-US/pages/documentation.thtml
index 0ce5bdb..dd73fd3 100755
--- a/en-US/pages/documentation.thtml
+++ b/en-US/pages/documentation.thtml
@@ -23,8 +23,8 @@
     <ul>
         <li><a href="#search-basic">Search Basics</a></li>
         <li><a href="#operators">Search Operators</a></li>
-        <li><a href="#result-formats">Result Formats</a></li>
         <li><a href="#tools">Search Tools Page</a></li>
+        <li><a href="#result-formats">Result Formats</a></li>
         <li><a href="#settings">Settings</a></li>
         <li><a href="#mobile">Mobile Interface</a></li>
     </ul>
@@ -958,6 +958,14 @@ lightning,bacteria,ant,dog,horse,person,oak tree,planet,star,galaxy
 it randomly chooses between more or less question. It then picks
 a subset of the ordered list of choices, randomly permutes them, and presents
 them to the user in a dropdown.</p>
+<p>Yioop's captcha-ing system tries to prevent attacks where a machine quickly
+tries several possible answers to a captcha. Yioop has a IP address based
+timeout system (implemented in models/visitor_model.php). Initially a timeout of
+one second between requests involving a captcha is in place. An error screen
+shows up if multiple requests from the same IP address for a captcha
+page are made within the time out period. Every mistaken entry of a captcha
+doubles this timeout period. The timeout period for an IP address is reset on
+a daily basis back to one second.</p>
     <p><a href="#toc">Return to table of contents</a>.</p>

     <h3 id='upgrade'>Upgrading Yioop</h3>
@@ -1405,6 +1413,29 @@ recentness. If one has RSS media sources which are set to be from
 different locales, then this will be taken into account on this blank query
 News page.</p>
 <p><a href="#toc">Return to table of contents</a>.</p>
+<h3 id='tools'>Search Tools Page</h3>
+<p>As one can see from the image of the main search form shown previously,
+the footer of each search and search result page has several links.
+Blog takes one to the group feed of the built in PUBLIC group which is
+editable from the root account, Privacy takes one to the Yioop installations
+privacy policy, and Terms takes one to the Yioop installations terms of service.
+The YioopBot link takes one to a page describing the installation's web crawler.
+These static pages are all Wiki pages of the PUBLIC group and can be edited
+by the root account. The Tools link takes one to the following page:</p>
+<img src='resources/SearchTools.png' alt='Search Tools Page'/>
+<p>Beneath the Other Search Sources section is a complete listing
+of all the search sources that were created using <a href="#sources"
+>Search Sources</a>. This might be more than just the Images, Video,
+and News that come by default with Yioop. The My Account section of this
+page gives another set of links for signing into, modifying the settings of,
+and creating account. The Other Tools section has a link to the form below
+where user's can suggest links for the current or future crawls.</p>
+<img src='resources/SuggestAUrl.png' alt='Suggest A Url Form'/>
+<p>This link only appears if under Server Settings, Account Registration
+is not set to Disable registration. The Wiki Pages link under Other Tools
+takes one to a searchable list of all Wiki pages of the default PUBLIC
+group.</p>
+    <p><a href="#toc">Return to table of contents</a>.</p>
 <h3 id='operators'>Search Operators</h3>
 <p>Turning now to the topic of how to enter a query in Yioop:
 A basic query to the Yioop search form is typically a sequence of
@@ -1584,10 +1615,6 @@ query to Yioop such as:
 <pre>
 http://my-yioop-instance-host/?f=json&amp;q=query+terms
 </pre>
-<h3 id='tools'>Search Tools Page</h3>
-<img src='resources/SearchTools.png' alt='Search Tools Page'/>
-<img src='resources/SuggestAUrl.png' alt='Suggest A Url Form'/>
-    <p><a href="#toc">Return to table of contents</a>.</p>

     <p><a href="#toc">Return to table of contents</a>.</p>
 <h3 id='settings'>Settings</h3>
ViewGit