diff --git a/CHANGELOG.md b/CHANGELOG.md
deleted file mode 100644
index d0e2a22..0000000
--- a/CHANGELOG.md
+++ /dev/null
@@ -1,32 +0,0 @@
-CHANGELOG
-=========
-
-0.3.1 (2016-04-13)
-------------------
-
-* fix: cover date was hidden by default, this was a backward breaking behavior
-
-0.3 the "beudbeud release" (2016-04-13)
----------------------------------------
-
-* caption support on bordered picture and pictures group https://github.com/Psycojoker/prosopopee#images-caption by beudbeud
-* configure licence https://github.com/Psycojoker/prosopopee#licence in footer by beudbeud
-* possibility to use a range for the full picture date https://github.com/Psycojoker/prosopopee#full-screen-picture-with-or-without-text-on-it by beudbeud
-* Update material theme by beudbeud
-* social share https://github.com/Psycojoker/prosopopee#share by beudbeud
-* Define background and text color of section https://github.com/abeudin/prosopopee#background-settings by beudbeud
-
-0.2 (2016-02-23)
-----------------
-
-* a lot new contributors stepped in, see https://github.com/Psycojoker/prosopopee#authors
-* possibility to specify an (optional) menu https://github.com/Psycojoker/prosopopee#menu made by beudbeud
-* configure Graphics Magick options on a global or per images fashion https://github.com/Psycojoker/prosopopee#gm and https://github.com/Psycojoker/prosopopee#images-handling by capslock and jmk
-* support for various themes and a new material theme in addition of the default one https://github.com/Psycojoker/prosopopee#gm by beudbeud
-* tags support in gallery settings https://github.com/Psycojoker/prosopopee#gallery-settingsyaml by beudbeud
-* introduce internal CACHE format version to avoid breaking build when changing it
-
-0.1 (2016-02-09)
-----------------
-
-* First pypi release
diff --git a/README.md b/README.md
index 4bb1fe6..0fdd4c7 100644
--- a/README.md
+++ b/README.md
@@ -12,523 +12,7 @@ You can find example usages here:
* http://outside.browny.pink
* http://such.life
-# Why?
-I wanted to learn a bit of advanced css and I wanted to self-host my data
-instead of using exposure.co.
+## Documentation
-## Requirements
-
-Installation needs Python, pip and virtualenv
-
- apt-get install python-pip python-virtualenv
-
-Gallery building needs graphicsmagick library
-
- apt-get install graphicsmagick
-
-## Installation
-
-1. Create a virtualenv, and activate it
-
-```
-virtualenv ve
-source ve/bin/activate
-```
-
-2. Download and install Prosopopee
-
-```
-pip install prosopopee
-```
-
-## Files organisation
-
-The files organisation is quite simple:
-
-* in the root directory of your project you need a settings.yaml file that will contains the title and subtitle of your gallery
-* for each gallery you'll need a folder that also contains a settings.yaml file that will describe how to display the content on your gallery
-* and you put the pictures of the gallery inside the gallery folder
-
-### Root settings.yaml
-
-The root settings.yaml should contains 2 keys : one for the title of your website and one for the subtitle. It should looks like that:
-
-```yaml
-title: My exploration of the outside world
-sub_title: it's a scary place, don't go there
-```
-
-It can also optionally contain a menu and global settings.
-
-#### Menu
-
-It is possible to add a menu to your homepage that links to static pages. To do so, add a `menu` key to your `settings.yaml`, for example:
-
-```yaml
-menu:
- - about: "About"
- - first_gallery: "My first gallery"
- - http://twitter.com: "Twitter"
-```
-
-For example, this could be the content of `settings.yaml` in `about` folder:
-
-```yaml
-title: "About"
-static: true
-public: false
-sections:
- - type: text
- text: Some text, HTML is allowed.
-```
-
-You can use the `static` option to get a template closer to the one of the
-homepage that is better suited for a static page. You'll need to specify
-"public: false" if you don't want to list this page on the homepage. On you
-case you didn't specified "public: false" you'll **need** to specify a "cover:"
-entry like any other gallery.
-
-**NOTE**: except the "static: " option to disepear quite soon for a more
-generic approach to "choose your page style".
-
-#### Global settings
-
-Global settings can be set in your root `settings.yaml`, under the `settings` key.
-
-##### GM
-
-Currently a `gm` settings key allows to customize the default GraphicsMagick's behavior. It looks like :
-
-```yaml
-settings:
- gm:
- quality: 75
- auto-orient: True
- strip: True
- resize: 50%
-```
-
-The meaning of the currently supported GraphicsMagick's settings is as follows :
-* `quality` allows to customize the compression level of thumbnails (between 0 and 100)
-* `auto-orient` change the orientation of pictures so they are upright (based on corresponding EXIF tags if present)
-* `strip` removes all profiles and text attributes from the image (good for privacy, slightly reduce file size)
-* `resize` can be used to resize the fullsize version of pictures. by default, input image size is preserved
-
-Any GraphicsMagick setting can be customized on a per-image basis (either `cover` or `image`, see below).
-
-##### Themes
-
-Prosopopée has a support for various themes. As for now, only 2 themes are available:
-
-* the default one called "exposure"
-* "material" based on materialcss
-
-To specify the theme, add the "theme" key in your "settings" key or your
-**root** settings.yaml. For example:
-
-```yaml
-title: My exploration of the outside world
-sub_title: it's a scary place, don't go there
-settings:
- theme: material
-```
-
-##### Licence
-
-By default Prosopopée use CC-BY-SA for all the content, if you want use a another licence
-you need add key in **root** settings.yaml. For example:
-
-```yaml
-licence:
- name: WTFPL
- url: "http://www.wtfpl.net/txt/copying/"
-```
-
-##### Share
-
-If you want enable the share content on social network, add key in **root** settings.yaml. For example:
-By defaut you can share on facebook, twitter, pinterest, google+.
-
-```yaml
-share: true
-url: "http://prosopopee.com/"
-```
-
-### Gallery settings.yaml
-
-This settings.yaml will describe:
-
-* the title, subtitle and cover picture of your gallery that will be used on the homepage
-* the tags is optional
-* if your gallery is public (if not, it will still be built but won't appear on the homepage)
-* the date of your gallery: this will be used on the homepage since **galleries are sorted anti chronologically** on it
-* the list of sections that will contains your gallery. A section will represent either one picture, a group of pictures or text. The different kind of sections will be explained in the next README section.
-
-Here is an example:
-
-```yaml
-title: Gallery title
-sub_title: Gallery sub-title
-date: 2016-01-15
-cover: my_cover_picture.jpg
-tags:
- - #yolo
- - #travel
-sections:
- - type: full-picture
- image: big_picture.jpg
- text:
- title: Big picture title
- sub_title: Some text
- date: 2016-01-15
- - type: pictures-group
- images:
- -
- - image1.jpg
- - image2.jpg
- - image3.jpg
- -
- - image4.jpg
- - image5.jpg
- - type: text
- text: Some text, HTML is allowed.
- - type: bordered-picture
- image: another_picture.jpg
-```
-
-And here is an example or a **private** gallery (notice the public keyword):
-
-```yaml
-title: Gallery title
-sub_title: Gallery sub-title
-date: 2016-01-15
-cover: my_cover_picture.jpg
-public: false
-sections:
- - ...
-```
-
-#### Images handling
-
-Images go into the `cover` or `image` keys.
-Each image individual processing settings can be customized to override the default
-GraphicsMagick settings defined (or not) in the root `settings.yaml`.
-
-This is done by putting the image path into a `name` key,
-and adding specific processing settings afterwards.
-
-For example, you can replace :
-
-```yaml
-image: image1.jpg
-```
-
-by:
-
-```yaml
-image:
- name: image1.jpg
- quality: 90
- strip: False
- auto-orient: False
-```
-
-### Different kind of sections
-
-A gallery is composed of a succession of sections as you can see on this [wonderfully
-totally uninteresting example
-gallery](http://psycojoker.github.io/prosopopee/first_gallery/) the gallery is
-composed of 5 sections:
-
-* a full screen picture with text written on it
-* a picture with borders around it
-* a group of 5 pictures
-* and a fullscreen picture without text on it this time
-
-In your settings.yaml, a section will **always** have a type key
-that will describe its kind and additional data. Underneath, the
-type key is actually the name of an HTML template and the other
-data will be passed to this template.
-
-You can find all the sections templates here: https://github.com/Psycojoker/prosopopee/tree/master/prosopopee/templates/sections
-
-You often have an image key. You need to give it a path to the
-actual file. By convention, those files are put inside your gallery folder but
-this is not mandatory.
-
-#### Full Screen picture with OR without text on it
-
-This displays a full screen picture as shown in the [example
-gallery](http://psycojoker.github.io/prosopopee/first_gallery/) in the first
-and last sections. How you should use it:
-
-With text:
-
-```yaml
- - type: full-picture
- image: big_picture.jpg
- text:
- title: Big picture title
- sub_title: Some text
- date: 2016-01-15
- date_end: 2016-01-24 (Optional)
-```
-
-Without text:
-
-```yaml
- - type: full-picture
- image: big_picture.jpg
-```
-
-#### Bordered picture
-
-This displays a centered picture that is surrounded by white (the background) as
-shown in the second position of the [example
-gallery](http://psycojoker.github.io/prosopopee/first_gallery/).
-
-How to use it:
-
-```yaml
- - type: bordered-picture
- image: another_picture.jpg
-```
-
-#### Group of pictures
-
-This displays a group of zoomable pictures on one or multiple lines as shown on
-the fourth position (after the text) of the [example
-gallery](http://psycojoker.github.io/prosopopee/first_gallery/).
-
-```yaml
- - type: pictures-group
- images:
- -
- - image1.jpg
- - image2.jpg
- - image3.jpg
- -
- - image4.jpg
- - image5.jpg
-```
-
-The first level `-` represent a line of pictures.
-The second level `-` represent the list of images in this line.
-
-**Know bug**: the images are left aligned, so if you don't put enough images on
-a line, you'll have white space on the right.
-
-#### Text
-
-This displays some centered text as shown on the third position of the [example
-gallery](http://psycojoker.github.io/prosopopee/first_gallery/). HTML is
-allowed inside the text.
-
-How to use it:
-
-```yaml
- - type: text
- text: Some text, HTML is allowed.
-```
-
-#### Paragraph
-
-This displays a h2 title followed by text. HTML is allowed inside of the text.
-If no title is declared, a separator is added.
-
-How to use it:
-
-```yaml
- - type: paragraph
- title: the title
- text: Some text, HTML is allowed.
-```
-
-#### HTML
-
-This section is for raw html that will be centered (for example: inlining an OSM iframe).
-
-How to use it:
-
-```yaml
- - type: html
- html: some html stuff