--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/source/introduction.rst Thu Dec 06 08:24:10 2018 +0100
@@ -0,0 +1,90 @@
+.. _introduction:
+
+Welcome to PyAMS's documentation!
+=================================
+
+.. warning::
+ This is a "work-in-progress" documentation. All elements described here are not publicly available yet.
+
+
+What is PyAMS?
+--------------
+
+**PyAMS** stands for **Py**\ramid **\A**\pplication **\M**\anagement **\S**\kin is a whole "Suite" of
+applications and content management tools with user friendly skin.
+
+
+What is Pyramid?
+----------------
+
+Pyramid is an open source Python web application framework. It is designed to make creating web applications easier.
+
+
+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.
+
+
+
+1.1. Overview
+
+Zope 2 is a free and open-source, object-oriented web application server written in the Python programming language. The term ZOPE is an acronym for “Z Object Publishing Environment” (the Z doesn’t really mean anything in particular). However, nowadays ZOPE is simply written as Zope. It has three distinct audiences.
+
+
+Developers
+ Individuals who wish to extend Zope to create highly customized solutions. This audience is likely interested in creating highly reusable custom code that makes Zope do something new and interesting. They will likely make heavy use of “through the file-system” style development.
+
+
+This guide is intended to document Zope for the second audience, Developers, as defined above. If you fit more into the “user” audience defined above, you’ll probably want to start by reading The Zope Book .
+
+Throughout this guide, it is assumed that you know how to program in the Python programming language. Most of the examples in this guide will be in Python. There are a number of great resources and books for learning Python; the best online resource is the python.org web site and many books can be found on the shelves of your local bookstore.
+1.2. Organization of the book
+
+This book describes Zope’s services to the developer from a hands on, example-oriented standpoint. This book is not a complete reference to the Zope API, but rather a practical guide to applying Zope’s services to develop and deploy your own web applications. This book covers the following topics:
+
+Getting Started
+ This chapter provides a brief overview of installation and getting started with application development.
+Components and Interfaces
+ Zope use a component-centric development model. This chapter describes the component model in Zope and how Zope components are described through interfaces.
+Object Publishing
+ Developing applications for Zope involves more than just creating a component, that component must be publishable on the web. This chapter describes publication, and how your components need to be designed to be published.
+Zope Products
+ New Zope components are distributed and installed in packages called “Products”. This chapter explains Products in detail.
+Persistent Components
+ Zope provides a built-in, transparent Python object database called ZODB. This chapter describes how to create persistent components, and how they work in conjunction with the ZODB.
+Acquisition
+ Zope relies heavily on a dynamic technique called acquisition. This chapter explores acquisition thoroughly.
+Security
+ When your component is used by many different people through the web, security becomes a big concern. This chapter describes Zope’s security API and how you can use it to make security assertions about your object.
+Debugging and Testing
+ Zope has built in debugging and testing support. This chapter describes these facilities and how you can debug and test your components.
+