diff --git a/README.md b/README.md
index 83420fe..6e2d099 100644
--- a/README.md
+++ b/README.md
@@ -10,5 +10,7 @@ default branch is currently  `dev`
 
 `main` will be used as the project becomes stable
 
+for changes, see [CHANGELOG](CHANGELOG.md)
 
+architecture decision records ([ADRs](docs/decisions/)) will be numbered over time.