diff --git a/README.md b/README.md
index 9ac270a..cce68f0 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,21 @@
 # CAcert OpenID connect parent project
 
+This repository references several repositories for the CAcert OpenID connect
+setup.
+
 ## Clone the repository
 
-```
+```shell
 git clone --recurse-submodules https://code.cacert.org/cacert/oidc-parent.git
 cd oidc-parent
 # cause pull, fetch and other git commands to consider submodules
 git config submodule.recurse true
 ```
+
+## Get started
+
+- [setup Hydra](https://code.cacert.org/cacert/oidc-hydra-config/src/branch/main/README.md)
+- build CAcert web application resources
+- setup IDP (provides login and consent screens)
+- setup demo application
+- setup setup OpenID Connect client registration application