Updated doc-dc
authorDamien Correia
Thu, 27 Dec 2018 17:13:08 +0100
branchdoc-dc
changeset 143 1d052540f8cd
parent 142 5a82a9a2ea46
child 144 4275975a87c8
Updated
src/source/glossary.rst
src/source/index.rst
src/source/overview.rst
src/source/screenshots.rst
--- a/src/source/glossary.rst	Fri Dec 21 17:28:34 2018 +0100
+++ b/src/source/glossary.rst	Thu Dec 27 17:13:08 2018 +0100
@@ -15,6 +15,7 @@
 		The back end is what your contributor see and interact with to add and manage  they come to your website.
 
 	Blog
+		Web page where the content is written in an informal or conversational style
 
 	Component
 		A component can be any Python object and has a particular purpose associated with it.
@@ -29,17 +30,21 @@
 		The block or paragraph is a component who can be include inside shared tools to build an editorial content.
 		PyAMS provides several block like "Key Number, enriched text or Galery
 
+	Contributor
+		someone who writes articles
+
 	Default theme
 		PyAMS comes with a default theme to display the front-end of the website.
 
 	Developer
-		A developer, or dev, is a computer programmer who be able to create,
-		modify, and update the software product or the source code.
+		A developer is a computer programmer who be able to create, modify, and update
+		the software and the source code.
 
 	Front-office
 		The front end is what your visitors see and interact with when they come to your website.
 
-	ManagerContributor
+	Manager
+
 
 	Permission
 
@@ -68,6 +73,7 @@
 	Visitor
 
 	Webmaster
+		A person responsible for the creation or maintenance of a website especially for a company or organization
 
 	Workflow
 
--- a/src/source/index.rst	Fri Dec 21 17:28:34 2018 +0100
+++ b/src/source/index.rst	Thu Dec 27 17:13:08 2018 +0100
@@ -19,7 +19,6 @@
    :maxdepth: 2
 
    Overview <overview>
-   Introduction <introduction>
    Quickstart <quickstart>
    Glossary <glossary>
 
--- a/src/source/overview.rst	Fri Dec 21 17:28:34 2018 +0100
+++ b/src/source/overview.rst	Thu Dec 27 17:13:08 2018 +0100
@@ -14,14 +14,61 @@
 to create a web page (see default theme gallery)
 
 
+
+.. _introduction:
+
+Why should I use PyAMS?
+-----------------------
+
+Based on the python langage, **PyAMS** supply powerfull tools like *PyAMS_content*, this package
+providing content management features, which can be easily extended to manage your own content types.
+But PyAMS can also be used to manage any kind of application.
+
+In addition **PyAMS** is built on top of **MyAMS** (**My** **\A**\pplication **\M**\anagement **\S**\kin), a small web client framework built on top of JQuery
+and Bootstrap, which was developed by the french national forestry office (ONF -- Office national des forĂȘts --
+http://www.onf.fr) to build web applications in several languages (actually java, Python and PHP). The new ONF website
+is now completely handled with PyAMS framework.
+
+PyAMS is a multipurpose set of packages, providing tools including:
+
+    * custom interfaces
+    * custom registry annotations
+    * custom security policy
+    * local registry support
+    * network protocols utilities (for HTTP and XML-RPC)
+    * command line scripts
+    * custom utilities.
+
+
+.. tip::
+    Some screenshots of the admin interface are available at :ref:`screenshots`!
+
+
+How to install PyAMS?
+---------------------
+
+If you want to create a PyAMS application instance easily, just follow the :ref:`quickstart` guide!
+If you want learn more about a custom installation follow :ref:`install` procedure.
+
+
+What can I realise with PyAMS?
+------------------------------
+
 Default theme gallery
----------------------
+^^^^^^^^^^^^^^^^^^^^^
+
+The default theme use bootstrap 3 library to build the :term:`front<Front-office>` user website
 
 
 Alternate skins gallery
------------------------
+^^^^^^^^^^^^^^^^^^^^^^^
 
-* Exemple ONF website
+* Example ONF website
 
 
+What PyAMS look like?
+---------------------
+
+To create a website with PyAMS, you will use to the friendly content manager interface.
+
 .. include:: screenshots.rst
--- a/src/source/screenshots.rst	Fri Dec 21 17:28:34 2018 +0100
+++ b/src/source/screenshots.rst	Thu Dec 27 17:13:08 2018 +0100
@@ -1,7 +1,7 @@
 .. _screenshots:
 
 PyAMS ZMI screenshots
----------------------
+^^^^^^^^^^^^^^^^^^^^^
 
 Here are a few screenshots of PyAMS management interface (called "ZMI", in memory of old Zope Management Interface).