src/source/appmanage.rst
branchdoc-dc
changeset 62 dc2bd8068d7a
parent 57 e7d62e94392f
child 104 942151432421
--- a/src/source/appmanage.rst	Wed May 16 12:00:26 2018 +0200
+++ b/src/source/appmanage.rst	Wed May 16 14:06:43 2018 +0200
@@ -16,7 +16,6 @@
 Local registry utilities
 ''''''''''''''''''''''''
 
-
 One of PyAMS pre-requisites is to use the ZODB, at least to store the site root application,
 it's configuration and a set of local utilities.
 
@@ -29,27 +28,38 @@
     to delete an index before recreating it by running the database upgrade script another time (see :ref:`scripts`).
 
 **Internal IDs** utility:
-    List of unique identifier used to localise and access easily to a resource or object declared in zo database.
+    The catalog object doesn't store direct references to objects, but their internal IDs which are generated by this
+    utility.
 
 **Language negotiator**:
-    Allows the management of several languages for different contents
+    As a web site or application can be localized, this utility allows you to define priorities between language
+    definition options (between *user session*, *browser* end *server*), and to define which languages are available
+    to your users (which is particularly important when managing potentially multi-lingual contents).
+
+    .. tip::
+        Static texts like those displayed into PyAMS management interface are always translated to the language defined
+        into browser language, if available.
 
 **Portal templates** container:
-    Allows you to define and save, one or more reuse template.
-    These templates can be shared with the entire application for build new site.
+    Portal templates are used to define *presentation templates* based on *portlets* (see :ref:`pyams_portal`). You can
+    create *local* templates, or create *shared templates* into this utility which can then be reused into several
+    places in your web site.
 
 **Security manager**:
-    Manage role and permission grant to a user
+    This utility is used to define authentication sources which will be available to authenticate your users.
+    :ref:`pyams_security` package provides several authentication modules (like local users, or via OAuth/OAuth2
+    providers); :ref:`pyams_ldap` add authentication plug-in via an LDAP directory.
 
 **Sequential IDs** utility:
-
+    This utility is used to assign simple sequential IDs to site contents (like sites, news, topics and more); these
+    IDs are simple to identify a given content; several versions of a given content handle by workflow share the same
+    sequential ID.
 
 **Server timezone** utility:
-    Setup the timezone server
+    Define the timezone server to display date and time accordingly.
 
 **User profiles** container:
-
-
+    This utility is used to store information associated to principals through their user profile.
 
 
 Optional utilities can also include: