diff --git a/README.md b/README.md
index 33d5771..542d2e8 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,12 @@ organization following the Spotify model.
 You could read [Discover the Spotify model by Atlassian](https://www.atlassian.com/agile/agile-at-scale/spotify)
 to learn more about it.
 
+**Nested Teams:** Github Team synchronization with Identity Providers feature
+does not work with nested teams, therefore, you need to have a flat structure and
+avoid such feature in GitHub if you would like to have such feature; because of
+that, we do not use nested teams for chapters, and squads, rather, we rely on
+the naming convention alone.
+
 ## What is next
 
 Check the list of submodules available.