diff --git a/README.md b/README.md
index 1640521..4f146c9 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ To run it:
 # install dependencies (one time only)
 npm install
 
-# build for production with minification (one time only)
+# build for production with minification (each time the sources changes)
 npm run build
 
 # run the Python webserver at localhost:3000
diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md
index f194c1e..b55ef1c 100644
--- a/docs/DEVELOPMENT.md
+++ b/docs/DEVELOPMENT.md
@@ -12,18 +12,42 @@ These are the paths you see in the browser (VueJS does client-side routing: no r
 - / - home; will redirect to the entry for today
 - /#/day/:day - show groups for the given date (in yyyy-mm-dd format)
 - /#/user/ - list of all users (only visible by admins)
-- /#/user/:user - show setting for the give user ID
+- /#/user/:id - show setting for the give user ID
 
 Web server
 ----------
 
+- /attendees GET - the list of all entries
+- /attendees POST - write a new entry
+- /attendees/:id GET - a single entry
+- /attendees/:id PUT - update an entry
+- /days GET - all entries, grouped by day and by group
+- /days/:day GET - a single day entries, grouped by group (yyyy-mm-dd format)
+- /users GET - list of all users
+- /users POST - create a new user
+- /users/:id GET - a single user
+- /users/:id PUT - update a user
+- /users/current GET - information about the currently logged in user
+- /login POST - login of a user
+- /logout GET - log the current user out
+
+Example of */attendees/:id*:
+``` json
+{"day": "2017-01-20", "name": "Attendee Name", "group": "Group Name", "updated_by": "587a7c79dff0d71c89211dc4", "created_at": "2017-01-20 13:57:26.029000", "updated_at": "2017-01-20 13:57:26.029000", "created_by": "587a7c79dff0d71c89211dc4", "_id": "58820936dff0d740dee647a4"}
+```
+
+Example of */days/:day*:
+``` json
+{"day": "2017-01-20", "groups": [{"name": "Group Name", "attendees": [{"day": "2017-01-20", "name": "Attendee Name", "group": "Group Name", "updated_by": "587a7c79dff0d71c89211dc4", "created_at": "2017-01-20 13:57:26.029000", "updated_at": "2017-01-20 13:57:26.029000", "created_by": "587a7c79dff0d71c89211dc4", "_id": "58820936dff0d740dee647a4"}]}]}
+```
+
+
 Database layout
 ===============
 
-Information are stored in MongoDB.  Whenever possible, object are converted into native ObjectId.
+Information are stored in MongoDB.  The *_id* key values are converted into native ObjectId.
 
-attendees collection
---------------------
+The main information are stored in the *attendees* collection.
 
 
 Code layout
@@ -32,6 +56,17 @@ Code layout
 The code is so divided:
 
     +- ibt2.py - the Tornado Web server
+    +- index.html - the html page that will be injected with the webApp
+    +- monco.py - backend to connect to a MongoDB instance
+    +- utils.py - various utilities
+    +- build/ - webpack and node configuration
+    +- dist/ - output of the build command will be put here
+    +- src/ - webApp sources
+       |
+       +- main.js - kickoff the VueJS webApp
+       +- App.vue - main component of the webApp
+       +- *.vue - other webApp components
+       +- state.js - shared state of the webApp
 
 
 Coding style and conventions
@@ -47,3 +82,18 @@ Python code documented following the [Sphinx](http://sphinx-doc.org/) syntax.
 not-so-FAQs
 ===========
 
+
+- **Q:** why the backend is not in Node.js? Why?! WHYYY!?!!?!
+- **A:** because science! (but mostly because I already had most of it ready from other projects)
+
+
+- **Q:** will it ever be ported to Python 3?
+- **A:** yes, probably in the near future.
+
+
+- **Q:** I've added a new path to the backend, and now the hot reload server is not working!!1!!
+- **A:** that's not even a question.  Anyway, add the path to dev.proxyTable in *config/index.js*
+
+
+- **Q:** will it be integrated with Slack?
+- **A:** hell, no.