some work on information architecture / nav

netlify.toml

@@ -133,5 +133,13 @@
 # The first upgrade guide lived under getting started. It has been moved to its own area.
 [[redirects]]
  from = "/get-started/upgrade-holochain/"
- to = "/upgrade/upgrade-holochain-0.2"
+ to = "/resources/upgrade/upgrade-holochain-0.2/"
  status = 301
+
+# Every time there's a new breaking release that achieves 'recommended' status,
+# update this temporary redirect. /resources/upgrade/latest/ isn't in the site nav,
+# but it is a handy URL we can hand out without needing to look up what the proper URL is.
+[[redirects]]
+ from = "/resources/upgrade/latest/"
+ to = "resources/upgrade/upgrade-holochain-0.2/"
+ status = 302

src/pages/_data/navigation/mainNav.json5

@@ -8,8 +8,6 @@
  { title: "Dev Tools Setup Tips", url: "/get-started/install-advanced/" },
  { title: "Setup Without Nix", url: "/get-started/install-without-nix/" },
  { title: "Distribute your App", url: "/get-started/distribute-your-app/" },
- { title: "Holochain Upgrade 0.1 → 0.2", url: "/upgrade/upgrade-holochain-0.2/" },
- { title: "Holochain Upgrade 0.2 → 0.3", url: "/upgrade/upgrade-holochain-0.3/" },
  { title: "Setup For a Local Event", url: "/get-started/at-an-event/" },
  ]
  },
@@ -33,6 +31,7 @@
  ]
  },
  { title: "Resources", url: "/resources/", children: [
+ { title: "Upgrade Guides", url: "/resources/upgrade/" },
  { title: "HDK", url: "https://docs.rs/hdk", external: true },
  { title: "HDI", url: "https://docs.rs/hdi", external: true },
  { title: "App API", url: "https://docs.rs/holochain_conductor_api/latest/holochain_conductor_api/enum.AppRequest.html", external: true },

src/pages/resources/index.md

@@ -17,6 +17,10 @@ tocData:
  href: tutorials-and-training
 ---
 
+## Upgrade guides
+
+If you're upgrading your hApp to a newer version of Holochain, we have some [upgrade guides](/resources/upgrade/) to make your work easier.
+
 ## HDK and HDI
 
 When you write a Holochain application, the part that lives in Holochain is called a [DNA](/concepts/2_application_architecture/#layers-of-the-application-stack). It runs as a guest in a WebAssembly sandbox and talks to the host, or Holochain conductor, through the host API. It's also expected to implement callbacks that the conductor needs to call at certain times. The HDK and HDI Rust crates make it easy for you write guest code that interfaces with the conductor --- the HDK for your DNA's [coordinator zomes](/resources/glossary/#coordinator-zome) and the HDI for [integrity zomes](/resources/glossary/#integrity-zome).

src/pages/upgrade/index.md → src/pages/resources/upgrade/index.md

@@ -8,5 +8,5 @@ hide:
 
 Upgrading between versions of Holochain can be a bit tricky! While Holochain is in beta, you can expect breaking changes between minor versions. To make upgrading your hApp easier, we create guides to help you move from one Holochain version to the next.
 
-* [Holochain Upgrade 0.1 → 0.2](/upgrade/upgrade-holochain-0.2/)
-* [Holochain Upgrade 0.2 → 0.3](/upgrade/upgrade-holochain-0.3/)
+* [Holochain Upgrade 0.1 → 0.2](/resources/upgrade/upgrade-holochain-0.2/)
+* [Holochain Upgrade 0.2 → 0.3](/resources/upgrade/upgrade-holochain-0.3/)