diff --git a/README.md b/README.md
index 38454830..a25cff32 100644
--- a/README.md
+++ b/README.md
@@ -19,11 +19,11 @@ It aims to be future proof, so it has to be aligned with the upcoming Volto visi
 
 ## Documentation
 
-You can find the documentation of this package in:
+You can find the documentation of this package in: https://volto-light-theme.readthedocs.io
 
 ## Upgrade Guide
 
-See a detailed upgrade guide in:
+See a detailed upgrade guide in: https://volto-light-theme.readthedocs.io/en/latest/upgrade-guide.html
 
 ## Requirements and specs
 
diff --git a/docs/index.md b/docs/index.md
index 04c3af9d..ac1518db 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -235,10 +235,6 @@ In general, the same rules as Volto releases applies.
 However, in VLT we add an extra exception: The vertical spacing is carefully curated and considered an important feature of the theme and because of that, changes and improvements in the vertical spacing are **NOT** considered breaking changes.
 They will be noted properly in the changelog.
 
-## Upgrade Guide
-
-See a detailed upgrade guide in: https://github.com/kitconcept/volto-light-theme/blob/main/UPGRADE-GUIDE.md
-
 ## Compatibility
 
 | VLT version | Volto version |
@@ -394,5 +390,5 @@ make release-rc
 ```{toctree}
 :maxdepth: 1
 upgrade-guide
-howto/how-to-register-and-retrieving-utilities
+block-model-v3
 ```