diff --git a/docs/.pages b/docs/.pages
index 013b7fa169910461df84bcd1ea21128bfb359588..5f3f62588108f406e7b4704fc45dd8b1fd1b044b 100644
--- a/docs/.pages
+++ b/docs/.pages
@@ -6,3 +6,4 @@ nav:
  - mobile
  - advanced
  - training
+ - for_developers
diff --git a/docs/advanced/.pages b/docs/advanced/.pages
deleted file mode 100644
index 14db1c060e1e0d343ba17408cea3b9a837cfd9cd..0000000000000000000000000000000000000000
--- a/docs/advanced/.pages
+++ /dev/null
@@ -1,7 +0,0 @@
-nav:
-- web-pages
-- restore_from_trash
-- privacy_considerations
-- api_access
-- migration_from_dfs
-- corner_cases
diff --git a/docs/advanced/corner_cases/README.md b/docs/advanced/corner_cases.md
similarity index 100%
rename from docs/advanced/corner_cases/README.md
rename to docs/advanced/corner_cases.md
diff --git a/docs/advanced/migration_from_dfs/index.md b/docs/advanced/migration_from_dfs.md
similarity index 100%
rename from docs/advanced/migration_from_dfs/index.md
rename to docs/advanced/migration_from_dfs.md
diff --git a/docs/advanced/privacy_considerations/index.md b/docs/advanced/privacy_considerations.md
similarity index 98%
rename from docs/advanced/privacy_considerations/index.md
rename to docs/advanced/privacy_considerations.md
index df975e49afd3b1dc4978a6866f4472178d94dee4..c300cc2821e42ed5b9a20c88c03db24e52e52682 100644
--- a/docs/advanced/privacy_considerations/index.md
+++ b/docs/advanced/privacy_considerations.md
@@ -1,3 +1,7 @@
+---
+title: Privacy considerations
+---
+
 # Privacy considerations when managing confidential data in CERNBox
 
 CERNBox is [suitable for storing personal data](https://cern.service-now.com/service-portal?id=kb_article&n=KB0003808), including sensitive personal data. CERNBox data and backups are always stored on the CERN premises.
diff --git a/docs/advanced/restore_from_trash/index.md b/docs/advanced/restore_from_trash.md
similarity index 100%
rename from docs/advanced/restore_from_trash/index.md
rename to docs/advanced/restore_from_trash.md
diff --git a/docs/advanced/api_access/index.md b/docs/for_developers/api_access.md
similarity index 94%
rename from docs/advanced/api_access/index.md
rename to docs/for_developers/api_access.md
index 736f606e0d0140562aa8f1363bac3cf59c7706e0..386ac3332f695904d66139e09627eda02d229e69 100644
--- a/docs/advanced/api_access/index.md
+++ b/docs/for_developers/api_access.md
@@ -1,7 +1,7 @@
 # API access to data in CERNBox
 
 !!! Warning
-    This access method is reserved to developers and integrators, who need to interact with CERNBox and/or the underlying EOS storage from another service. End users should use the available regular [access methods](../../desktop/other-access-methods/desktop-mobile-access.md).
+    This access method is reserved to developers and integrators, who need to interact with CERNBox and/or the underlying EOS storage from another service. End users should use the available regular [access methods](../desktop/other-access-methods/desktop-mobile-access.md).
 
 If you are a developer and your workflow requires programmatic access to CERNBox and/or EOS, you can follow these guidelines to automate specific actions.
 
@@ -19,7 +19,7 @@ If you have created a public link on a folder with _edit_ or _uploader_ rights,
 
 `curl -T <some-file> -X PUT https://cernbox.cern.ch/remote.php/dav/public-files/<public-link-hash>/<target-filename>`
 
-Note that for _uploader_ links, the target file gets an extra hash appended to the name, to prevent collisions as the user does not have rights to list or overwrite existing content (see also [sharing](../../web/sharing/public-share.md)).
+Note that for _uploader_ links, the target file gets an extra hash appended to the name, to prevent collisions as the user does not have rights to list or overwrite existing content (see also [sharing](../web/sharing/public-share.md)).
 
 
 ## Protected shares