--- a/src/source/userguide.rst	Tue Aug 14 18:26:02 2018 +0200
+++ b/src/source/userguide.rst	Tue Aug 14 18:27:10 2018 +0200
@@ -4,40 +4,227 @@
 ==================
 
 Users or Site Managers
-    Individuals who use PyAMS features to create a custom application or website.
+	Individuals who use PyAMS features to create a custom application or website.
+
+
+To Begin
+--------
+
+Login
+^^^^^
+
+Begin by logging into the “administration area” or the back end of your website.
+Now log into PyAMS using your username and password.
+
+	.. image:: _static/pyams-login.png
+
+
+Dashboard
+^^^^^^^^^
+
+After logging in you are on the main Administration Screen called the Dashboard. This is the starting point to create page and article
+also settings your workspace. If you are lost click on "Home" to come back on the Dashboard.
+
+	.. image:: _static/pyams-dashboard.png
+
+
+
+At the top of the screen is the “toolbar”, this navigation menu is to create new publication content (site , article, view...)
+On the left side of the screen is the main navigation menu detailing each of the administrative functions you can perform.
+
+
+Article - The shared contents
+-----------------------------
+
+
+Articles are sorted by category news, topic or long read, each category have different attributes, and they can quickly
+identify the type of content.
+
+The News are a short article to spotlight an information. This is typically the type of content used for blog posts or news feeds
+
+
+Create a News
+^^^^^^^^^^^^^
+
+To create a News, click on the "Shared contents" on the top bar and select "News" then click on **+ Add news topic**
+
+	.. image:: _static/add_newtopic.png
+
+(*) The progress bar below the title is an indicator to optimize for indexation by search engines.
+
+When you are completed the form you will be redirected and invited to complete the properties of the article
+
+
+Manage a News
+^^^^^^^^^^^^^
+
+	.. image:: _static/content_properties.png
+
+
+On this page you can modify the title and the url display, content description and write an unpublish note
+
+In Addition you can wrapped the articles with custom feature like:
+
+- A header or main illustration placed on the top of your article
+- An illustration for the links that targets the article.
+
+
+The interface also allows you to perform additional actions such as publishing and versioning but, we will come back to it later
+
+
+
+Edit the content of an article
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+PyAMS offers a user-friendly interface for editing the content of an article, to do that, move on the side bar
+and the section **Composition** and click on **Contents...**
+
+	.. image:: _static/select_paragraph.png
+
+An article is composed of many paragraphs or blocks. Depending on the configuration of the shared tool,
+one or more paragraphs may already be present when creating a new article to help the author structure his document.
+
+Each paragraph corresponds to a type of media and will facilitate the modification the articulation of an article.
+To add a new block, click **Add ..**
+
+	.. image:: _static/content_paragraph.png
+
+(*) The list of available paragraph varies depending on the nature of the article and the configuration of the shared tools
 
 
-How to create a web site Page and blog?
----------------------------------------
+Paragraph
+---------
+
+Header
+^^^^^^
+
+Rich Text
+^^^^^^^^^
+
+Illustration
+^^^^^^^^^^^^
+
+Media Gallery
+^^^^^^^^^^^^^
+
+Video
+^^^^^
+
+External video
+^^^^^^^^^^^^^^
+
+Audio
+^^^^^
+
+Associations
+^^^^^^^^^^^^
+
+Contact
+^^^^^^^
+
+Framed Text
+^^^^^^^^^^^
+
+Image Maps
+^^^^^^^^^^
+
+Key number
+^^^^^^^^^^
+
+Key point
+^^^^^^^^^
+
+Location number
+^^^^^^^^^^^^^^^
+
+Logos
+^^^^^
+
+Milestones
+^^^^^^^^^^
+
+Pictogram
+^^^^^^^^^
+
+Verbatim
+^^^^^^^^
+
+Raw HTML
+^^^^^^^^
+
+Verify the content
+------------------
+
+Audit
+^^^^^
+
+Preview
+^^^^^^^
+
+
+Publishing an Article
+---------------------
+
+When you are writing an article, it's not already visible for the visitors, but when the content is ready the editor
+has the possibility to make a request by clicking on the button **Change status**.
+
+
+	.. image:: _static/content_publish_toolbar.png
+
+
+You will be asked to validate the date of publication and check if the content corresponds to your expectations,
+
+	.. image:: _static/content_publication_form.png
+
+
+If you work alone the validated content will be put online.
+
+
+If you have collaborators, you have the possibility to used a publication workflow that include reviewers. The editor
+make a **Request of publication** to the review for the validation of the request. Then, the reviewer receives a
+notification inviting him to consult the article in question.
+
+The reviewer has the choice to accept or refuse the publication or also create a new version of the article.
+
+
+.. warning::
+
+	Important**: Once published the content can not be erased,
+	However you can always unpublish it to remove the access to visitors.
+
+
+Web site Page / Blog
+--------------------
 
 To create a new page for your website click on `Site tree`
 
 
-    .. image:: _static/select_sitetree.png
-
-
-
-Click on **+ + Add...** and choose the to create a `blog` or a `site manager`
-
-
-    .. image:: _static/select_website_content.png
+	.. image:: _static/select_sitetree.png
 
 
 A blog or weblog is a simple editorial structure where news and topics are stacked in a chronological order.
 
+Click on **+ Add...** and choose the to create a `blog` or a `site manager`
 
-Website Portal Templates
-------------------------
+
+	.. image:: _static/select_website_content.png
+
+
+
 
-You can create a generic template shared for all users, to do that ya need to have some admin privilege.
+Website Design
+---------------
+
+You can create a generic template shared for all users, to do that ya need to have some webdesign privilege.
+
 
 On the `Control panel`,  click on `Portal Templates`
 
-    .. image:: _static/select_portlet.png
+	.. image:: _static/select_portlet.png
 
-In the Portal Templates menu
+For example In the Portal Templates menu
 
-    .. image:: _static/user_create_template.png
+	.. image:: _static/user_create_template.png
 
 1) Click on **+add template**
 2) Name your new template
@@ -65,17 +252,9 @@
 
 
 
-
-How to create a News?
----------------------
-
-    .. image:: _static/select_paragraph.png
+How to add content in the page ?
+--------------------------------
 
 
-How to create a Topic?
-----------------------
-
-
-
-Publishing content
-------------------
+Une fois le contenu d'un article disponible et publié, vous aurez surmenet besion de le faire apparaitre dans votre site ou blog
+Pour lier un article a un site ou un blog.