diff --git a/people/README.md b/people/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..28245cf4f8a4c45763067433f15d5388437eb714
--- /dev/null
+++ b/people/README.md
@@ -0,0 +1,17 @@
+Technical directions on adding a page
+------------------------------------------
+
+To add a new page, create a file of the form `<first initial><surname>.md` in this
+directory, taking the existing files as examples. Any auxiliary files (e.g. CV, ... should
+have form `<first initial><surname>-<aux>.<ext>`.
+
+Each file  needs some specific parameters:
+
+ * **layout** use *person* 
+ * **menu_title** (optional) the slot title  in the menu, use your full name, leave out
+   for auxiliary pages. 
+ * **fullname** 
+ * **fulltitle**
+ * **affiliation** the acaddmic affiliation 
+ * **account** (the base name of the file)
+ * **cv** link to a CV.