--- a/docs/README.txt	Wed Nov 27 19:37:28 2019 +0100
+++ b/docs/README.txt	Wed Nov 27 19:39:45 2019 +0100
@@ -0,0 +1,29 @@
+======================
+PyAMS_pagelet package
+======================
+
+.. contents::
+
+
+What is PyAMS?
+==============
+
+PyAMS (Pyramid Application Management Suite) is a small suite of packages written for applications
+and content management with the Pyramid framework.
+
+**PyAMS** is actually mainly used to manage web sites through content management applications (CMS),
+see PyAMS_content package), but many features are generic and can be used inside any kind of web
+application.
+
+
+What is PyAMS_pagelet?
+======================
+
+This package is an update of z3c.pagelet package for use with Pyramid.
+
+PyAMS_template allows to separate a view's Python code from it's template implementation, so that
+this template can be easilly overriden for a given view or a given layer.
+
+PyAMS_pagelet now allows to split a view template into two parts, which are the content template
+and the layout template, so that any or both of them can be overriden for a given view or layer,
+without creating a new view.