diff --git a/README.md b/README.md
index 7213f115a55edf852eb03cfd6ff308863af0d9f2..892edf1a282150e1b5e2a9c4e7866474d4ae3295 100644
--- a/README.md
+++ b/README.md
@@ -15,13 +15,17 @@ This can be done online by clicking on `Edit this page` in the navigation menu.
 See the above links for details.
 
 * `_config.yml`: main configuration page
-* `_post/*.md`: sources of the news, blog posts and activities
-* `_data/*.yml`: YAML database from which certain pages are automatically generated
+* `_includes/*`: reusable chunks of web pages, like the nav bar 
 * `_layouts/*`: local style files
-* `_includes/*`: reusable chunks of web pages, like the nav bar
+* `_post/*.md`: sources of the news, blog posts and activities
+* `news/*`: the KWARC news are generated here. 
+* `people/*.md`: the KWARC home pages 
+* `projects/*.md`: the KWARC project descriptions
 * `public/*`: all static files (images, js, css, etc)
-* `project/` -- people -- event_activites: folders used to generate menu pages (as set in `_config.yml`)
-* `_tagpages` : the tag pages, each tag gets an almost empty md file so that the tag page gets generated by jekyll
+* `public/*.md`: descriptions of the research areas
+* `students/*.md`: pages for students
+* `systems/*.md`: descriptions of the KWARC sytems 
+* `teaching/*.md`: KWARC courses (this may be obsoleted by univis)
 
 ## Performance
 This jekyll page is tuned in order to build as fast as possible.