system/ReSeeD-user-management.md

@@ -114,6 +114,42 @@ To prepare the file hyrax/seed/setup.json, copy the template file and modify the
 
 The user details will not be updated. So restarting a container will not overwrite any existing user details.
 
+---
+
+### [TLDR] Setting up users
+This section contains only the most crucial steps to adding a new user, e.g. for participants in ReSeeD- Workshops.
+
+##### Open the desired web container
+```bash
+$ docker exec -it reseed-training-web-1 /bin/bash # Example
+```
+Your desired web container might differ from the example above.
+
+##### Preparing the JSON file
+Copy hyrax/seed/setup.json.template to hyrax/seed/users.json:
+```bash
+$ cp -a hyrax/seed/setup.json.template hyrax/seed/users.json
+```
+Now add the desired user attributes to the users.json file.
+
+Here's an example for an entry using an orcid- ID to authenticate:
+```json
+{
+  "users": [
+    {
+      "email": "max.mustermann@ruhr-uni-bochum.de",
+      "orcid": "0000-0000-0000-0000",
+      "name": "Max Mustermann"
+    }
+  ]
+}
+```
+
+##### Running the rake task
+```bash
+$ rake rdms:setup_users["/data/seed/users.json", "false"]
+```
+
 ### Setup.json (prior to v0.3.6)
 
 Previous to release [v0.3.6](https://gitlab.ruhr-uni-bochum.de/researchdata/rdms/-/tags/v0.3.6), the file [hyrax/seed/setup.json](https://gitlab.ruhr-uni-bochum.de/researchdata/rdms/-/blob/aad36d72974b4f8fd2753e91d44e08a7d4e9429e/hyrax/seed/setup.json) was available. This has now been renamed to [setup.json.template](https://gitlab.ruhr-uni-bochum.de/researchdata/rdms/-/blob/develop/hyrax/seed/setup.json.template) and extended to show how to create all of the different types of users, and roles. If you would like the file previous to release v0.3.6, download it using