diff --git a/README.md b/README.md
index c3df2ee..507d878 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,5 @@
-<!--- Register repository https://api.reuse.software/register, then add REUSE badge:
-[![REUSE status](https://api.reuse.software/badge/github.com/SAP-samples/REPO-NAME)](https://api.reuse.software/info/github.com/SAP-samples/REPO-NAME)
--->
+[![REUSE status](https://api.reuse.software/badge/github.com/SAP-samples/btp-admin-guide-samples)](https://api.reuse.software/info/github.com/SAP-samples/btp-admin-guide-samples)
+[![Periodic Link Checker](https://github.com/SAP-samples/btp-admin-guide-samples/actions/workflows/links-watcher-cron.yml/badge.svg)](https://github.com/SAP-samples/btp-admin-guide-samples/actions/workflows/links-watcher-cron.yml)
 
 # SAP BTP - Administrator's Guide Samples
 
@@ -12,7 +11,11 @@ These samples show the implementation of the recommendations using Infrastructur
 
 ## Content Structure
 
-TODO
+The samples are available in the folder `sample-setups`. We provide each scenario in a separate folder. Each folder contains a `README.md` file describing the details.
+
+You find further details in the [`READEME.md`](./sample-setups/README.md) file of the `sample-setups` folder and in the `README.md` files of the individual sample setups
+
+In addition, we have a folder `modules` containing reusable Terraform modules. These modules are used in the sample setups.
 
 ## Getting Support
 
diff --git a/sample-setups/README.md b/sample-setups/README.md
index 1142e68..3504c4d 100644
--- a/sample-setups/README.md
+++ b/sample-setups/README.md
@@ -2,7 +2,7 @@
 
 ## Paradigms
 
-We follow the paradigms of a simple and clear Terraform configuration as laid out in [Simple, Clear, Maintainable](https://rosesecurity.dev/blog/2024/11/24/terraform-proverbs); especially:
+We follow the paradigms of a simple and clear Terraform configuration as laid out in [Simple, Clear, Maintainable](https://rosesecurity.dev/2024/11/24/terraform-proverbs.html); especially:
 
 - Clear is better than clever.
 - Modules should be reusable, not rigid.