cleanup useless files

Author: Thierry Boileau

README.md

@@ -0,0 +1,35 @@
+# Introduction
+
+The Website of the Restlet Framework is developed with Hugo: https://gohugo.io/
+
+That's a great rule to test any update locally, so install Hugo: https://gohugo.io/installation/
+Then run `hugo server` and reach http://localhost:1313.
+
+Hugo allows live updates, which is a very nice feature.
+However, once you're done with your updates:
+
+- stop the server
+- drop these two directories: `./public` and `./resources`
+- run again `hugo server`
+  It's a great habit to check your updates.
+
+# Directories
+
+| Directory | Comment                                                                                               |
+|-----------|-------------------------------------------------------------------------------------------------------|
+| `assets`  | SASS files that are transpiled into CSS                                                               |
+| `content` | pages of the Website: this is the main place for your updates                                         |
+| `data`    | yaml files to be used in layout code (cf themes/restlet-framework/layouts/_shortcodes/downloads.html) |
+| `static`  | CSS, JS files                                                                                         |
+| `themes`  | the definition of the layout                                                                          |
+
+# Layouts and partials
+
+Pages are organized by their main directory:
+ - the pages inside the root directory
+ - the pages inside the `downloads` directory
+ - the pages inside the `documentation` directory
+ - the pages inside the `documentation/changelog` directory
+
+They are handled by the `baseof.html` template of the exact same directory in the layouts `./themes/restlet-framework/layouts`. As you can notice, there is no `downloads` directory: the layout in the root directory applies.
+Layout include what is called `partials` (located in `./themes/restlet-framework/partials`) this is where all the logic of html code generation resides.