diff --git a/content/reference/introduction.md b/content/reference/introduction.md
index 69058d2c..cf591cbf 100644
--- a/content/reference/introduction.md
+++ b/content/reference/introduction.md
@@ -1,14 +1,16 @@
 ---
-title: API References
-description: API references for Ocean Protocol components.
+title: API & Library References
+description: All the references for Ocean Protocol components.
 ---
 
-The following components expose a consumable API:
+**Heads Up! This reference section is in heavy development and updated as we integrate data from various code reference tools into this site.**
+
+The following components expose a consumable REST API which are documented on this site:
 
 <repo name="aquarius"></repo>
 <repo name="brizo"></repo>
 
-Those libraries ...:
+References of all the functions and methods used in our libraries are not yet integrated here. For now, have a look at the respective repos for more infos:
 
 <repo name="squid-js"></repo>
 <repo name="squid-py"></repo>
diff --git a/data/repositories.yml b/data/repositories.yml
index 326808f3..d9ec9e6f 100644
--- a/data/repositories.yml
+++ b/data/repositories.yml
@@ -8,12 +8,12 @@
     - name: aquarius
       links:
         - name: API reference
-          url: /api/aquarius/
+          url: /reference/aquarius/
 
     - name: brizo
       links:
         - name: API reference
-          url: /api/brizo/
+          url: /reference/brizo/
 
     - name: pleuston