From d5d3b598ba0dbd6d0ed1b6cbe99f572bce778626 Mon Sep 17 00:00:00 2001
From: andie787 <4andie@gmail.com>
Date: Mon, 25 Sep 2023 17:49:59 -0400
Subject: [PATCH] update nav and move index

---
 apps/volume-manage.html.markerb                          | 7 +++----
 apps/volume-storage.html.markerb                         | 4 ++--
 partials/_firecracker_nav.html.erb                       | 9 +--------
 reference/volumes.html.markerb                           | 6 +++---
 .../index.html.markerb                                   | 7 ++++---
 5 files changed, 13 insertions(+), 20 deletions(-)
 rename apps/volume-index.html.markerb => volumes/index.html.markerb (81%)

diff --git a/apps/volume-manage.html.markerb b/apps/volume-manage.html.markerb
index 8dd15eb171..e003219d75 100644
--- a/apps/volume-manage.html.markerb
+++ b/apps/volume-manage.html.markerb
@@ -1,8 +1,8 @@
 ---
 title: Manage volume storage
-layout: docs
+layout: framework_docs
 nav: firecracker
-order: 30
+order: 40
 ---
 
 How to manage volumes using the [`fly volumes`](/docs/flyctl/volumes/) command.
@@ -156,7 +156,6 @@ For options, refer to the [`fly vol destroy` docs](/docs/flyctl/volumes-destroy/
 
 ## Related topics
 
-- [How Fly Volumes work](/docs/reference/volumes/)
+- [Volumes overview](/docs/reference/volumes/)
 - [Add volume storage](/docs/apps/volume-storage/)
-- [`mounts` section](/docs/reference/configuration/#the-mounts-section) in the `fly.toml` Fly Launch configuration file
 - [Scale an app with volumes](/docs/apps/scale-count/#scale-an-app-with-volumes)
\ No newline at end of file
diff --git a/apps/volume-storage.html.markerb b/apps/volume-storage.html.markerb
index e9d30f9063..ff15ec2765 100644
--- a/apps/volume-storage.html.markerb
+++ b/apps/volume-storage.html.markerb
@@ -2,7 +2,7 @@
 title: Add volume storage
 layout: docs
 nav: firecracker
-order: 20
+order: 30
 ---
 
 Fly Volumes are local persistent storage for [Fly Machines](/docs/machines/). Learn [how Fly Volumes work](/docs/reference/volumes/).
@@ -187,7 +187,7 @@ The volume is mounted in the directory specified by the `destination` field in t
 
 ## Related topics
 
-- [How Fly Volumes work](/docs/reference/volumes/)
+- [Volumes overview](/docs/reference/volumes/)
 - [Manage volume storage](/docs/apps/volume-manage/)
 - [`mounts` section](/docs/reference/configuration/#the-mounts-section) in the `fly.toml` Fly Launch configuration file
 - [Scale an app with volumes](/docs/apps/scale-count/#scale-an-app-with-volumes)
\ No newline at end of file
diff --git a/partials/_firecracker_nav.html.erb b/partials/_firecracker_nav.html.erb
index 2f7d5fe398..a9b28c5911 100644
--- a/partials/_firecracker_nav.html.erb
+++ b/partials/_firecracker_nav.html.erb
@@ -61,12 +61,6 @@
       <li>
         <%= nav_link "Get Information about an App", "/docs/apps/info/" %>
       </li>
-      <li>
-        <%= nav_link "Add Volume Storage", "/docs/apps/volume-storage/" %>
-      </li>
-      <li>
-        <%= nav_link "Manage Volume Storage", "/docs/apps/volume-manage/" %>
-      </li>
       <li>
         <%= nav_link "Scale Machine CPU and RAM", "/docs/apps/scale-machine/" %>
       </li>
@@ -102,8 +96,7 @@
     <%= nav_link "Databases & Storage", "/docs/database-storage-guides/" %>
     <ul role="region" aria-label="Databases & Storage">
       <li>
-        <%= nav_link "Volumes", "/docs/apps/volume-index" %>
-      </li>
+        <%= nav_link "Volumes", "/docs/volumes" %>
       <li>
         <%= nav_link "Fly Postgres", "/docs/postgres/" %>
       </li>
diff --git a/reference/volumes.html.markerb b/reference/volumes.html.markerb
index 864b4ed588..b3eac582d3 100644
--- a/reference/volumes.html.markerb
+++ b/reference/volumes.html.markerb
@@ -1,8 +1,8 @@
 ---
-title: How Fly Volumes work
-layout: docs
+title: Volumes overview
+layout: framework_docs
 nav: firecracker
-order: 10
+order: 20
 ---
 
 Apps can store only ephemeral data on the root file systems of their Machines, because a Machine’s file system gets rebuilt from scratch each time you deploy your app, or when the Machine is restarted. 
diff --git a/apps/volume-index.html.markerb b/volumes/index.html.markerb
similarity index 81%
rename from apps/volume-index.html.markerb
rename to volumes/index.html.markerb
index 244efbb581..4590f7012a 100644
--- a/apps/volume-index.html.markerb
+++ b/volumes/index.html.markerb
@@ -1,17 +1,18 @@
 ---
 title: "Fly Volumes"
 layout: docs
-toc: false
 nav: firecracker
+toc: false
+order: 10
 ---
 
 Volumes are local persistent storage for [Fly Machines](/docs/machines/).
 
 ## Learn
 
-Get the details and concepts behind volumes.
+Understand how volumes work and whether they're right for your use case.
 
-[How Fly Volumes work](/docs/reference/volumes/)
+[Volumes overview](/docs/reference/volumes/)
 
 ## How-Tos