treeverse · ozkatz · Jun 6, 2025 · Jun 6, 2025
diff --git a/cmd/lakectl/cmd/docs.go b/cmd/lakectl/cmd/docs.go
@@ -13,7 +13,6 @@ import (
 var cliReferenceHeader = `---
 title: lakectl (lakeFS command-line tool)
 description: lakeFS comes with its own native CLI client. Here you can see the complete command reference.
-parent: Reference
 redirect_from:
   - /reference/commands.html
   - /quickstart/lakefs_cli.html

diff --git a/docs/_includes/nav.html b/docs/_includes/nav.html
diff --git a/docs/enterprise/architecture.md b/docs/enterprise/architecture.md
@@ -2,7 +2,6 @@
 title: Architecture
 description: lakeFS Enterprise architecture explained
 nav_order: 220
-parent: lakeFS Enterprise
 ---
 
 

diff --git a/docs/enterprise/configuration.md b/docs/enterprise/configuration.md
@@ -2,7 +2,6 @@
 title: Configuration Reference
 description: a configuration reference for lakeFS Enterprise
 nav_order: 215
-parent: lakeFS Enterprise
 ---
 
 # lakeFS Enterprise Configuration Reference

diff --git a/docs/enterprise/getstarted/index.md b/docs/enterprise/getstarted/index.md
@@ -1,8 +1,6 @@
 ---
 title: Get Started
 description: Methods for getting started with lakeFS Enterprise
-parent: lakeFS Enterprise
-has_children: true
 has_toc: false
 nav_order: 200
 ---

diff --git a/docs/enterprise/getstarted/install.md b/docs/enterprise/getstarted/install.md
@@ -1,8 +1,6 @@
 ---
 title: Install
 description: lakeFS Enterprise Installation Guide
-parent: Get Started
-grand_parent: lakeFS Enterprise
 nav_order: 202
 ---
 

diff --git a/docs/enterprise/getstarted/migrate-from-oss.md b/docs/enterprise/getstarted/migrate-from-oss.md
@@ -1,8 +1,6 @@
 ---
 title: Migrate from lakeFS OSS
 description: How to migrate from lakeFS OSS to lakeFS Enterprise
-parent: Get Started
-grand_parent: lakeFS Enterprise
 nav_order: 203
 ---
 

diff --git a/docs/enterprise/getstarted/quickstart.md b/docs/enterprise/getstarted/quickstart.md
@@ -1,8 +1,6 @@
 ---
 title: Quickstart
 description: Quickstart guides for lakeFS Enterprise
-parent: Get Started
-grand_parent: lakeFS Enterprise
 nav_order: 201
 ---
 

diff --git a/docs/enterprise/index.md b/docs/enterprise/index.md
@@ -1,7 +1,7 @@
 ---
 title: lakeFS Enterprise
-description: lakeFS Enterprise is an enterprise-ready lakeFS solution providing additional features including RBAC, SSO and Support SLA.
-has_children: true
+description: lakeFS Enterprise is an enterprise-ready lakeFS solution providing additional
+  features including RBAC, SSO and Support SLA.
 has_toc: false
 nav_order: 110
 ---

diff --git a/docs/enterprise/troubleshooting.md b/docs/enterprise/troubleshooting.md
@@ -2,7 +2,6 @@
 title: Troubleshooting lakeFS Enterprise
 description: Guidance on troubleshooting a lakeFS Enterprise deployment
 nav_order: 210
-parent: lakeFS Enterprise
 ---
 
 # Troubleshooting lakeFS Enterprise

diff --git a/docs/enterprise/upgrade.md b/docs/enterprise/upgrade.md
@@ -2,7 +2,6 @@
 title: Upgrade
 description: How to upgrade lakeFS Enterprise
 nav_order: 205
-parent: lakeFS Enterprise
 ---
 
 # Upgrade

diff --git a/docs/experimental/lakectl_local_posix.md b/docs/experimental/lakectl_local_posix.md
@@ -1,7 +1,7 @@
 ---
 title: lakectl local file permissions tracking
-description: An experimental feature that allows tracking file ownership and permissions when using lakectl local
-parent: none
+description: An experimental feature that allows tracking file ownership and permissions
+  when using lakectl local
 ---
 
 # lakectl local file permission tracking

diff --git a/docs/howto/backup-and-restore.md b/docs/howto/backup-and-restore.md
@@ -1,7 +1,7 @@
 ---
 title: Backup and Restore Repository
-description: Use the lakeFS DumpRefs and RestoreRefs commands to backup and restore lakeFS repository
-parent: How-To
+description: Use the lakeFS DumpRefs and RestoreRefs commands to backup and restore
+  lakeFS repository
 ---
 
 # Backup and Restore Repository

diff --git a/docs/howto/catalog_exports.md b/docs/howto/catalog_exports.md
@@ -1,7 +1,7 @@
 ---
 title: Data Catalogs Exports
-description: This section explains how lakeFS can integrate with external Data Catalogs via metastore update operations. 
-parent: How-To
+description: This section explains how lakeFS can integrate with external Data Catalogs
+  via metastore update operations.
 ---
 
 # Data Catalogs Export

diff --git a/docs/howto/copying.md b/docs/howto/copying.md
@@ -1,10 +1,9 @@
 ---
 title: Copying data to/from lakeFS
-description: 
-parent: How-To
-redirect_from: 
-  - /integrations/distcp.html
-  - /integrations/rclone.html
+description:
+redirect_from:
+- "/integrations/distcp.html"
+- "/integrations/rclone.html"
 ---
 
 # Copying data to/from lakeFS

diff --git a/docs/howto/deploy/aws.md b/docs/howto/deploy/aws.md
@@ -1,16 +1,17 @@
 ---
 title: AWS
-grand_parent: How-To
-parent: Install lakeFS
-description: How to deploy and set up a production-suitable lakeFS environment on AWS
+description: How to deploy and set up a production-suitable lakeFS environment on
+  AWS
 redirect_from:
-   - /deploying-aws/index.html
-   - /deploying-aws/install.html
-   - /deploying-aws/db.html
-   - /deploying-aws/lb_dns.html
-   - /setup/storage/s3.html 
-   - /deploy/aws.html 
-next:  ["Import data into your installation", "/howto/import.html"]
+- "/deploying-aws/index.html"
+- "/deploying-aws/install.html"
+- "/deploying-aws/db.html"
+- "/deploying-aws/lb_dns.html"
+- "/setup/storage/s3.html"
+- "/deploy/aws.html"
+next:
+- Import data into your installation
+- "/howto/import.html"
 ---
 
 # Deploy lakeFS on AWS

diff --git a/docs/howto/deploy/azure.md b/docs/howto/deploy/azure.md
@@ -1,12 +1,13 @@
 ---
 title: Azure
-grand_parent: How-To
-parent: Install lakeFS
-description: How to deploy and set up a production-suitable lakeFS environment on Microsoft Azure
+description: How to deploy and set up a production-suitable lakeFS environment on
+  Microsoft Azure
 redirect_from:
-   - /setup/storage/blob.html 
-   - /deploy/azure.html 
-next:  ["Import data into your installation", "/howto/import.html"]
+- "/setup/storage/blob.html"
+- "/deploy/azure.html"
+next:
+- Import data into your installation
+- "/howto/import.html"
 ---
 
 # Deploy lakeFS on Azure

diff --git a/docs/howto/deploy/gcp.md b/docs/howto/deploy/gcp.md
@@ -1,12 +1,13 @@
 ---
 title: GCP
-grand_parent: How-To
-parent: Install lakeFS
-description: How to deploy and set up a production-suitable lakeFS environment on Google Cloud Platform (GCP).
+description: How to deploy and set up a production-suitable lakeFS environment on
+  Google Cloud Platform (GCP).
 redirect_from:
-   - /setup/storage/gcs.html 
-   - /deploy/gcp.html 
-next:  ["Import data into your installation", "/howto/import.html"]
+- "/setup/storage/gcs.html"
+- "/deploy/gcp.html"
+next:
+- Import data into your installation
+- "/howto/import.html"
 ---
 
 # Deploy lakeFS on GCP

diff --git a/docs/howto/deploy/index.md b/docs/howto/deploy/index.md
@@ -1,16 +1,15 @@
 ---
 title: Install lakeFS
-parent: How-To
-description: This section will guide you through deploying and setting up a production lakeFS environment.
-has_children: true
+description: This section will guide you through deploying and setting up a production
+  lakeFS environment.
 has_toc: false
 nav_order: 1
 redirect_from:
-  - /setup/
-  - /setup/storage/index.html
-  - /setup/create-repo.html
-  - /deploy/
-  - /deploy/index.html
+- "/setup/"
+- "/setup/storage/index.html"
+- "/setup/create-repo.html"
+- "/deploy/"
+- "/deploy/index.html"
 ---
 
 # Deploy and Setup lakeFS

diff --git a/docs/howto/deploy/onprem.md b/docs/howto/deploy/onprem.md
@@ -1,16 +1,17 @@
 ---
 title: On-Premises
-grand_parent: How-To
-parent: Install lakeFS
-description: How to deploy and set up a production-suitable lakeFS environment on-premises (or on other cloud providers)
+description: How to deploy and set up a production-suitable lakeFS environment on-premises
+  (or on other cloud providers)
 redirect_from:
-   - /deploy/k8s.html
-   - /deploy/docker.html 
-   - /integrations/minio.html
-   - /using/minio.html
-   - /deploy/onprem.html
-   - /deploying/install.html
-next:  ["Import data into your installation", "/howto/import.html"]
+- "/deploy/k8s.html"
+- "/deploy/docker.html"
+- "/integrations/minio.html"
+- "/using/minio.html"
+- "/deploy/onprem.html"
+- "/deploying/install.html"
+next:
+- Import data into your installation
+- "/howto/import.html"
 ---
 
 # On-Premises Deployment

diff --git a/docs/howto/deploy/upgrade.md b/docs/howto/deploy/upgrade.md
@@ -1,12 +1,10 @@
 ---
 title: Upgrade lakeFS
 description: How to upgrade lakeFS to the latest version.
-grand_parent: How-To
-parent: Install lakeFS
-redirect_from: 
-  - /deploying-aws/upgrade.html
-  - /reference/upgrade.html
-  - /howto/upgrade.html
+redirect_from:
+- "/deploying-aws/upgrade.html"
+- "/reference/upgrade.html"
+- "/howto/upgrade.html"
 ---
 
 # Upgrading lakeFS

diff --git a/docs/howto/export.md b/docs/howto/export.md
@@ -1,9 +1,9 @@
 ---
 title: Export Data
-description: Use the lakeFS Spark client or RClone inside Docker to export a lakeFS commit to the object store.
-parent: How-To
-redirect_from: 
-  - /reference/export.html
+description: Use the lakeFS Spark client or RClone inside Docker to export a lakeFS
+  commit to the object store.
+redirect_from:
+- "/reference/export.html"
 ---
 
 # Exporting Data

diff --git a/docs/howto/garbage-collection/gc.md b/docs/howto/garbage-collection/gc.md
@@ -1,18 +1,16 @@
 ---
 title: Garbage Collection
 description: Clean up expired objects using the garbage collection feature in lakeFS.
-parent: Garbage Collection
-grand_parent: How-To
 nav_order: 1
 redirect_from:
-  - /howto/garbage-collection/index.html
-  - /howto/garbage-collection/committed.html
-  - /howto/garbage-collection/uncommitted.html
-  - /howto/garbage-collection/internals.html
-  - /reference/garbage-collection.html
-  - /howto/garbage-collection-index.html
-  - /howto/garbage-collection.html
-  - /reference/retention.html
+- "/howto/garbage-collection/index.html"
+- "/howto/garbage-collection/committed.html"
+- "/howto/garbage-collection/uncommitted.html"
+- "/howto/garbage-collection/internals.html"
+- "/reference/garbage-collection.html"
+- "/howto/garbage-collection-index.html"
+- "/howto/garbage-collection.html"
+- "/reference/retention.html"
 ---
 
 # Garbage Collection

diff --git a/docs/howto/garbage-collection/index.md b/docs/howto/garbage-collection/index.md
@@ -1,7 +1,5 @@
 ---
 title: Garbage Collection
 description: Clean up expired objects using the garbage collection feature in lakeFS.
-parent: How-To
-has_children: true
 ---
 [lakeFS Cloud](https://lakefs.cloud) users enjoy a [managed garbage collection]({% link howto/garbage-collection/managed-gc.md %}) service, and do not need to run this Spark program.
diff --git a/docs/howto/garbage-collection/managed-gc.md b/docs/howto/garbage-collection/managed-gc.md
@@ -1,12 +1,11 @@
 ---
 title: Managed Garbage Collection
 description: Reduce the operational overhead of running garbage collection manually.
-parent: Garbage Collection
 nav_order: 5
-grand_parent: How-To
-badges: ["Enterprise"]
+badges:
+- Enterprise
 redirect_from:
-  - /cloud/managed-gc.html
+- "/cloud/managed-gc.html"
 ---
 
 # Managed Garbage Collection

diff --git a/docs/howto/garbage-collection/standalone-gc.md b/docs/howto/garbage-collection/standalone-gc.md
@@ -1,12 +1,11 @@
 ---
 title: Standalone Garbage Collection
 description: Run a limited version of garbage collection without any external dependencies
-parent: Garbage Collection
 nav_order: 5
-grand_parent: How-To
-badges: ["Enterprise"]
+badges:
+- Enterprise
 redirect_from:
-  - /cloud/standalone-gc.html
+- "/cloud/standalone-gc.html"
 ---
 
 # Standalone Garbage Collection

diff --git a/docs/howto/hooks/airflow.md b/docs/howto/hooks/airflow.md
@@ -1,10 +1,8 @@
 ---
 title: Airflow Hooks
-parent: Actions and Hooks
-grand_parent: How-To
 description: Airflow Hooks Reference
 redirect_from:
-   - /hooks/airflow.html
+- "/hooks/airflow.html"
 ---
 
 # Airflow Hooks

diff --git a/docs/howto/hooks/index.md b/docs/howto/hooks/index.md
@@ -1,17 +1,15 @@
 ---
 title: Actions and Hooks
 description: Overview of lakeFS Actions and Hooks
-has_children: true  
 has_toc: false
-parent: How-To
 nav_order: 3
 redirect_from:
-  - /reference/hooks.html
-  - /hooks.html
-  - /hooks/overview.html
-  - /hooks/index.html
-  - /hooks/
-  - /setup/hooks.html
+- "/reference/hooks.html"
+- "/hooks.html"
+- "/hooks/overview.html"
+- "/hooks/index.html"
+- "/hooks/"
+- "/setup/hooks.html"
 ---
 
 # Actions and Hooks in lakeFS

diff --git a/docs/howto/hooks/lua.md b/docs/howto/hooks/lua.md
@@ -1,10 +1,8 @@
 ---
 title: Lua Hooks
-parent: Actions and Hooks
-grand_parent: How-To
-description: Lua Hooks reference 
+description: Lua Hooks reference
 redirect_from:
-   - /hooks/lua.html
+- "/hooks/lua.html"
 ---