update readme

1 files changed, 7 insertions, 2 deletions

diff --git a/README.md b/README.md
index b0a5644..f97c6b0 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,10 @@
-See `bin/normalize-stdio` for a listing of all the directives in
-`hackers.yml`.
+Users ("hackers") are added by creating a file in the `users/`
+directory.  The file should be named `users/${UID}.yml` where UID is
+the numeric POSIX user ID for that user.  See
+`bin/meta-normalize-stdio` for a listing of all the properties you can
+put in the users file; or look at the existing files as examples.
+
+To add a profile image of a user, add it to the `dev-imgs/` folder.
 
 Images in `dev-imgs/`:
  - MUST be named `${username}.png`