docs(website): Show the documented version in the navbar only

Naming the release in both the navbar and the footer was one place too many. The
footer is the copy-free one, but it sits below a page of flags where nobody sees
it, so the badge stays and the footer partial goes.

Comments trimmed with it, including one that had gone stale: the footer
described HUGO_PARAMS_VERSION, which stopped existing when the version became a
release-please-bumped literal in hugo.yaml.

Author: khvn26

internal/cmd/root.go

@@ -174,9 +174,7 @@ func nudgeInit(cmd *cobra.Command) bool {
 	return true
 }
 
-// Root returns the fully wired command tree, for callers that need to inspect
-// it rather than run it — documentation generation, shell completions. It never
-// executes a command, so no credential or network access is involved.
+// Root returns the command tree for cmd/docgen
 func Root() *cobra.Command {
 	prepare()
 	return rootCmd

website/README.md

@@ -18,9 +18,8 @@ Then open <http://localhost:1313>. Re-run `docgen` after changing help text.
 
 ## What is hand-written
 
-| Path                                   | Purpose                            |
-| -------------------------------------- | ---------------------------------- |
-| `hugo.yaml`                            | Site config, navigation, theme     |
-| `layouts/_partials/navbar-title.html`  | Theme override: version badge      |
-| `layouts/_partials/custom/footer.html` | Names the release being documented |
-| `layouts/home.html`                    | Theme override                     |
+| Path                                  | Purpose                        |
+| ------------------------------------- | ------------------------------ |
+| `hugo.yaml`                           | Site config, navigation, theme |
+| `layouts/_partials/navbar-title.html` | Theme override: version badge  |
+| `layouts/home.html`                   | Theme override                 |

website/hugo.yaml

@@ -45,9 +45,6 @@ menu:
         icon: github
 
 params:
-  # The release this build documents, shown beside the navbar title and in the
-  # footer. Bumped by release-please, which is why website/hugo.yaml is one of
-  # its extra-files.
   version: "v2.0.0-beta.3" # x-release-please-version
   description: The Flagsmith command-line interface — manage flags, segments and environments from your terminal.
   navbar:

website/layouts/_partials/custom/footer.html

@@ -1,15 +1,6 @@
 {{/*
-  Hextra has no hook for navbar content, so this is the theme's own
-  navbar-title.html with a version badge added beside the title. The version
-  belongs where it is seen without scrolling: a reader arriving from a search
-  result on an older CLI should not have to reach the footer to find out which
-  release the page describes.
-
-  The auto margin that pushes the menu to the right moves onto the badge when
-  there is one, so the badge sits beside the title rather than beside the menu.
-
-  Copied from hextra@v0.12.3 layouts/_partials/navbar-title.html; re-check when
-  bumping the theme.
+  Copied from hextra@v0.12.3 to add the version badge, which has no hook. The
+  auto margin moves onto the badge so it sits beside the title.
 */}}
 {{- $logoPath := .Site.Params.navbar.logo.path | default "images/logo.svg" -}}
 {{- $logoLink := .Site.Params.navbar.logo.link | default .Site.Home.RelPermalink -}}

website/layouts/_partials/navbar-title.html

@@ -1,11 +1,6 @@
 {{/*
-  The site is the command reference, so the home page is the `flagsmith` root
-  command's own page and needs the command tree beside it. Hextra's home layout
-  passes disableSidebar, which would leave the front page with no navigation at
-  all, so use the layout the theme gives any other reference page.
-
-  Copied from hextra@v0.12.3 layouts/docs/list.html; re-check when bumping the
-  theme.
+  Customise the homepage (copied from `hextra@v0.12.3`) in order to update the
+  sidebar to match flagsmith's command structure.
 */}}
 {{ define "main" }}
   <div class='hx:mx-auto hx:flex hextra-max-page-width'>