diff --git a/docs/manage/reference/agent.md b/docs/manage/reference/viam-agent/_index.md
similarity index 100%
rename from docs/manage/reference/agent.md
rename to docs/manage/reference/viam-agent/_index.md
diff --git a/docs/operate/reference/manage-viam-agent.md b/docs/manage/reference/viam-agent/manage-viam-agent.md
similarity index 100%
rename from docs/operate/reference/manage-viam-agent.md
rename to docs/manage/reference/viam-agent/manage-viam-agent.md
diff --git a/docs/operate/reference/kinematic-chain-config.md b/docs/operate/reference/kinematic-chain-config.md
index aaadf24629..72ebb0061f 100644
--- a/docs/operate/reference/kinematic-chain-config.md
+++ b/docs/operate/reference/kinematic-chain-config.md
@@ -1,7 +1,7 @@
 ---
 title: "Configure Complex Kinematic Chains"
 linkTitle: "Complex Kinematic Chains"
-weight: 50
+weight: 200
 type: "docs"
 description: "Define kinematic parameters to configure intermediate reference frames for components with complex kinematic chains."
 tags: ["slam", "services"]
diff --git a/docs/operate/reference/orientation-vector.md b/docs/operate/reference/orientation-vector.md
index 6bd0ddd356..50a0d8d42b 100644
--- a/docs/operate/reference/orientation-vector.md
+++ b/docs/operate/reference/orientation-vector.md
@@ -1,7 +1,7 @@
 ---
 title: "Orientation Vector"
 linkTitle: "Orientation Vector"
-weight: 40
+weight: 190
 type: "docs"
 description: "A description of Viam's orientation vector object."
 aliases:
diff --git a/docs/operate/reference/viam-micro-server.md b/docs/operate/reference/viam-micro-server/_index.md
similarity index 100%
rename from docs/operate/reference/viam-micro-server.md
rename to docs/operate/reference/viam-micro-server/_index.md
diff --git a/docs/operate/reference/viam-micro-server-setup.md b/docs/operate/reference/viam-micro-server/viam-micro-server-setup.md
similarity index 100%
rename from docs/operate/reference/viam-micro-server-setup.md
rename to docs/operate/reference/viam-micro-server/viam-micro-server-setup.md
diff --git a/docs/operate/reference/viam-server.md b/docs/operate/reference/viam-server/_index.md
similarity index 100%
rename from docs/operate/reference/viam-server.md
rename to docs/operate/reference/viam-server/_index.md
diff --git a/docs/operate/reference/local-configuration-file.md b/docs/operate/reference/viam-server/local-configuration-file.md
similarity index 100%
rename from docs/operate/reference/local-configuration-file.md
rename to docs/operate/reference/viam-server/local-configuration-file.md
diff --git a/docs/operate/reference/manage-viam-server.md b/docs/operate/reference/viam-server/manage-viam-server.md
similarity index 100%
rename from docs/operate/reference/manage-viam-server.md
rename to docs/operate/reference/viam-server/manage-viam-server.md