From 07f6c54f22f4b722b2ee8e34f1cd8c2dcce4b0f1 Mon Sep 17 00:00:00 2001
From: Everett Pompeii <epompeii@protonmail.com>
Date: Fri, 6 Oct 2023 09:58:55 -0400
Subject: [PATCH] open_graph

---
 .vscode/settings.json                         |  3 +
 services/console/astro.config.mjs             | 13 ++-
 services/console/public/robots.txt            |  3 +
 .../console/perf/plot/PlotHeader.tsx          | 10 +--
 .../console/src/components/site/Footer.tsx    | 73 +++++++++++-----
 services/console/src/content/config.ts        |  5 ++
 .../src/content/explanation/adapters.mdx      |  1 +
 .../src/content/explanation/bencher-run.mdx   |  1 +
 .../src/content/explanation/benchmarking.mdx  |  1 +
 .../content/explanation/branch-selection.mdx  |  1 +
 .../explanation/continuous-benchmarking.mdx   |  1 +
 .../console/src/content/explanation/talks.mdx |  1 +
 .../src/content/explanation/thresholds.mdx    |  1 +
 .../src/content/how_to/github-actions.mdx     |  1 +
 .../src/content/how_to/gitlab-ci-cd.mdx       |  1 +
 .../src/content/how_to/install-cli.mdx        |  1 +
 .../src/content/how_to/track-benchmarks.mdx   |  1 +
 .../console/src/content/legal/license.mdx     |  1 +
 services/console/src/content/legal/plus.mdx   |  1 +
 .../console/src/content/legal/privacy.mdx     |  1 +
 .../src/content/legal/subscription.mdx        |  1 +
 .../src/content/legal/terms-of-use.mdx        |  1 +
 .../src/content/reference/changelog.mdx       |  1 +
 .../src/content/reference/prior-art.mdx       |  1 +
 .../console/src/content/reference/roadmap.mdx |  1 +
 .../src/content/reference/server-config.mdx   | 85 ++++++++++---------
 .../console/src/content/tutorial/docker.mdx   |  1 +
 .../src/content/tutorial/quick-start.mdx      |  1 +
 services/console/src/layouts/BaseLayout.astro | 39 ++++-----
 .../console/src/layouts/docs/DocsLayout.astro |  9 +-
 .../src/layouts/legal/LegalLayout.astro       |  9 +-
 .../console/src/layouts/perf/PerfLayout.astro |  6 +-
 services/console/src/pages/404.astro          |  6 +-
 .../src/pages/docs/explanation/[slug].astro   |  6 +-
 .../src/pages/docs/how-to/[slug].astro        |  6 +-
 services/console/src/pages/docs/index.astro   |  4 +-
 .../src/pages/docs/reference/[slug].astro     |  6 +-
 .../src/pages/docs/reference/api.astro        |  3 +-
 .../pages/docs/reference/architecture.astro   |  3 +-
 .../src/pages/docs/tutorial/[slug].astro      |  6 +-
 .../src/pages/docs/tutorial/quick-start.astro |  1 +
 services/console/src/pages/help.astro         |  4 +-
 services/console/src/pages/index.astro        | 14 +--
 services/console/src/pages/legal/[slug].astro |  6 +-
 services/console/src/pages/legal/index.astro  |  6 +-
 .../console/src/pages/perf/[project].astro    |  5 +-
 services/console/src/pages/perf/index.astro   |  6 +-
 services/console/src/pages/pricing.astro      | 17 ++--
 48 files changed, 252 insertions(+), 123 deletions(-)

diff --git a/.vscode/settings.json b/.vscode/settings.json
index aa5f57c75..ff046d655 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -16,6 +16,9 @@
     "editor.formatOnSave": true,
     "editor.defaultFormatter": "rust-lang.rust-analyzer"
   },
+  "[astro]": {
+    "editor.formatOnSave": false,
+  },
   "[javascript]": {
     "editor.formatOnSave": true,
     "editor.defaultFormatter": "rome.rome"
diff --git a/services/console/astro.config.mjs b/services/console/astro.config.mjs
index 3e0a474d9..f21ff09b8 100644
--- a/services/console/astro.config.mjs
+++ b/services/console/astro.config.mjs
@@ -13,7 +13,9 @@ export default defineConfig({
 	output: "hybrid",
 	integrations: [
 		// https://docs.astro.build/en/guides/integrations-guide/sitemap
-		sitemap(),
+		sitemap({
+			filter: sitemapFilter,
+		}),
 		// https://docs.astro.build/en/guides/integrations-guide/mdx
 		mdx(),
 		// https://docs.astro.build/en/guides/integrations-guide/partytown
@@ -34,3 +36,12 @@ export default defineConfig({
 		remarkPlugins: [remarkGfm],
 	},
 });
+
+// https://docs.astro.build/en/guides/integrations-guide/sitemap/#filter
+const sitemapFilter = (page) =>
+	!(
+		page.includes("bencher.dev/console") ||
+		page.includes("bencher.dev/chat") ||
+		page.includes("bencher.dev/demo") ||
+		page.includes("bencher.dev/repo")
+	);
diff --git a/services/console/public/robots.txt b/services/console/public/robots.txt
index 0c3d4adb3..3b20e84ca 100644
--- a/services/console/public/robots.txt
+++ b/services/console/public/robots.txt
@@ -1,5 +1,8 @@
 User-agent: *
 Disallow: /console$
 Disallow: /console/
+Disallow: /chat$
 Disallow: /demo$
 Disallow: /repo$
+
+Sitemap: https://bencher.dev/sitemap-index.xml
diff --git a/services/console/src/components/console/perf/plot/PlotHeader.tsx b/services/console/src/components/console/perf/plot/PlotHeader.tsx
index ce7bf70df..63aa5d213 100644
--- a/services/console/src/components/console/perf/plot/PlotHeader.tsx
+++ b/services/console/src/components/console/perf/plot/PlotHeader.tsx
@@ -164,11 +164,11 @@ const PlotHeader = (props: Props) => {
 										class="icon-text"
 										data-tooltip="Display lower/upper Metric values"
 									>
-										<span>⠀Value</span>
+										<span style="padding-left: 1em">Value</span>
 										<span class="icon">
 											<i class="fas fa-info-circle" aria-hidden="true" />
 										</span>
-										<span>⠀</span>
+										<span style="padding-right: 1em"></span>
 									</div>
 									<div class="columns">
 										<div class="column">
@@ -236,11 +236,11 @@ const PlotHeader = (props: Props) => {
 											class="icon-text"
 											data-tooltip="Toggle X-Axis between Date and Branch Version"
 										>
-											<span>⠀X-Axis</span>
+											<span style="padding-left: 0.5em">X-Axis</span>
 											<span class="icon">
 												<i class="fas fa-info-circle" aria-hidden="true" />
 											</span>
-											<span>⠀</span>
+											<span style="padding-right: 0.5em"></span>
 										</div>
 										<div class="columns">
 											<div class="column">
@@ -319,7 +319,7 @@ const PlotHeader = (props: Props) => {
 					<div class="level-item">
 						<div class="columns">
 							<div class="column">
-								<p>⠀Clear⠀</p>
+								<p style="padding-left: 1em;padding-right: 1em;">Clear</p>
 								<div class="columns">
 									<div class="column">
 										<button
diff --git a/services/console/src/components/site/Footer.tsx b/services/console/src/components/site/Footer.tsx
index d09db49b8..3d0335174 100644
--- a/services/console/src/components/site/Footer.tsx
+++ b/services/console/src/components/site/Footer.tsx
@@ -3,31 +3,58 @@ import { BENCHER_GITHUB_URL, BENCHER_CHAT_URL } from "../../util/ext";
 const Footer = () => (
 	<footer class="footer" style="margin-top:1rem;">
 		<div class="container">
-			<div class="content">
-				<nav class="level">
-					<div class="level-left">
-						<div class="level-item has-text-centered">
-							<p>
-								<a href="/legal/terms-of-use">Terms of Use</a>
-							</p>
-						</div>
-						<div class="level-item has-text-centered">
-							<p>
-								<a href="/legal/privacy">Privacy Policy</a>
-							</p>
-						</div>
-						<div class="level-item has-text-centered">
-							<p>
-								<a href="/legal/license">License Agreement</a>
-							</p>
-						</div>
-					</div>
-				</nav>
-			</div>
-			<div class="columns is-mobile">
+			<div class="columns is-vcentered is-mobile">
 				<div class="column">
 					<div class="content">
-						<p>Bencher - Continuous Benchmarking</p>
+						<h4 class="title">🐰 Bencher - Continuous Benchmarking</h4>
+						<nav class="level">
+							<div class="level-left">
+								<div class="level-item has-text-centered">
+									<p>
+										<a href="/docs">Docs</a>
+									</p>
+								</div>
+								<div class="level-item has-text-centered">
+									<p>
+										<a href="/pricing">Pricing</a>
+									</p>
+								</div>
+								<div class="level-item has-text-centered">
+									<p>
+										<a href="/help">Help</a>
+									</p>
+								</div>
+								<div class="level-item has-text-centered">
+									<p>
+										<a href="/legal">Legal</a>
+									</p>
+								</div>
+								<div class="level-item has-text-centered">
+									<p>
+										<a href="/sitemap-index.xml">Sitemap</a>
+									</p>
+								</div>
+							</div>
+						</nav>
+						<nav class="level">
+							<div class="level-left">
+								<div class="level-item has-text-centered">
+									<p>
+										<a href="/legal/terms-of-use">Terms of Use</a>
+									</p>
+								</div>
+								<div class="level-item has-text-centered">
+									<p>
+										<a href="/legal/privacy">Privacy Policy</a>
+									</p>
+								</div>
+								<div class="level-item has-text-centered">
+									<p>
+										<a href="/legal/license">License Agreement</a>
+									</p>
+								</div>
+							</div>
+						</nav>
 					</div>
 				</div>
 				<div class="column is-narrow">
diff --git a/services/console/src/content/config.ts b/services/console/src/content/config.ts
index c4300f433..a420906db 100644
--- a/services/console/src/content/config.ts
+++ b/services/console/src/content/config.ts
@@ -6,6 +6,7 @@ const legal = defineCollection({
 	type: "content", // v2.5.0 and later
 	schema: z.object({
 		title: z.string(),
+		description: z.string(),
 		heading: z.string(),
 		sortOrder: z.number(),
 	}),
@@ -14,6 +15,7 @@ const tutorial = defineCollection({
 	type: "content", // v2.5.0 and later
 	schema: z.object({
 		title: z.string(),
+		description: z.string(),
 		heading: z.string(),
 		sortOrder: z.number(),
 	}),
@@ -22,6 +24,7 @@ const how_to = defineCollection({
 	type: "content", // v2.5.0 and later
 	schema: z.object({
 		title: z.string(),
+		description: z.string(),
 		heading: z.string(),
 		sortOrder: z.number(),
 	}),
@@ -30,6 +33,7 @@ const explanation = defineCollection({
 	type: "content", // v2.5.0 and later
 	schema: z.object({
 		title: z.string(),
+		description: z.string(),
 		heading: z.string(),
 		sortOrder: z.number(),
 	}),
@@ -38,6 +42,7 @@ const reference = defineCollection({
 	type: "content", // v2.5.0 and later
 	schema: z.object({
 		title: z.string(),
+		description: z.string(),
 		heading: z.string(),
 		sortOrder: z.number(),
 	}),
diff --git a/services/console/src/content/explanation/adapters.mdx b/services/console/src/content/explanation/adapters.mdx
index 706f4e8e3..3d54667ef 100644
--- a/services/console/src/content/explanation/adapters.mdx
+++ b/services/console/src/content/explanation/adapters.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Benchmark Adapters"
+description: "Use your favorite code benchmark harness with Bencher's built in adapters or use a custom code benchmark harness that outputs JSON"
 heading: "Benchmark Harness Adapters"
 sortOrder: 3
 ---
diff --git a/services/console/src/content/explanation/bencher-run.mdx b/services/console/src/content/explanation/bencher-run.mdx
index b45513669..cc908fdd5 100644
--- a/services/console/src/content/explanation/bencher-run.mdx
+++ b/services/console/src/content/explanation/bencher-run.mdx
@@ -1,5 +1,6 @@
 ---
 title: "bencher run"
+description: "Overview of the bencher run CLI subcommand and all of its flags, arguments, and features"
 heading: "bencher run CLI Subcommand"
 sortOrder: 2
 ---
diff --git a/services/console/src/content/explanation/benchmarking.mdx b/services/console/src/content/explanation/benchmarking.mdx
index 2b1aedc05..1bfa75ccd 100644
--- a/services/console/src/content/explanation/benchmarking.mdx
+++ b/services/console/src/content/explanation/benchmarking.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Benchmarking Overview"
+description: "The conceptual model and vocabulary used by Bencher to track the results of code benchmarks"
 heading: "Benchmarking Overview"
 sortOrder: 1
 ---
diff --git a/services/console/src/content/explanation/branch-selection.mdx b/services/console/src/content/explanation/branch-selection.mdx
index 260fe6fcf..de0021bee 100644
--- a/services/console/src/content/explanation/branch-selection.mdx
+++ b/services/console/src/content/explanation/branch-selection.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Branch Selection"
+description: "Overview of the ways to select a git branch using the bencher run CLI subcommand"
 heading: "Branch Selection with bencher run"
 sortOrder: 3
 ---
diff --git a/services/console/src/content/explanation/continuous-benchmarking.mdx b/services/console/src/content/explanation/continuous-benchmarking.mdx
index f016df826..14523e8ca 100644
--- a/services/console/src/content/explanation/continuous-benchmarking.mdx
+++ b/services/console/src/content/explanation/continuous-benchmarking.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Continuous Benchmarking"
+description: "Continuous Benchmarking is a software development practice where members of a team benchmark their code frequently and catch performance regressions in CI"
 heading: "What is Continuous Benchmarking?"
 sortOrder: 5
 ---
diff --git a/services/console/src/content/explanation/talks.mdx b/services/console/src/content/explanation/talks.mdx
index b49446a1f..ab7286471 100644
--- a/services/console/src/content/explanation/talks.mdx
+++ b/services/console/src/content/explanation/talks.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Bencher Talks"
+description: "Talks about Bencher and Continuous Benchmarking by Everett Pompeii"
 heading: "Bencher Talks"
 sortOrder: 6
 ---
diff --git a/services/console/src/content/explanation/thresholds.mdx b/services/console/src/content/explanation/thresholds.mdx
index fc7739f2c..948a1c498 100644
--- a/services/console/src/content/explanation/thresholds.mdx
+++ b/services/console/src/content/explanation/thresholds.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Thresholds & Alerts"
+description: "Overview of using thresholds to catch performance regressions in code benchmarks with alerts"
 heading: "Thresholds & Alerts"
 sortOrder: 4
 ---
diff --git a/services/console/src/content/how_to/github-actions.mdx b/services/console/src/content/how_to/github-actions.mdx
index 55152df92..4d8118b5a 100644
--- a/services/console/src/content/how_to/github-actions.mdx
+++ b/services/console/src/content/how_to/github-actions.mdx
@@ -1,5 +1,6 @@
 ---
 title: "GitHub Actions"
+description: "Use Bencher in GitHub Actions for continuous benchmarking on pull requests"
 heading: "How to use Bencher in GitHub Actions"
 sortOrder: 3
 ---
diff --git a/services/console/src/content/how_to/gitlab-ci-cd.mdx b/services/console/src/content/how_to/gitlab-ci-cd.mdx
index 461ae6df6..39fa63fed 100644
--- a/services/console/src/content/how_to/gitlab-ci-cd.mdx
+++ b/services/console/src/content/how_to/gitlab-ci-cd.mdx
@@ -1,5 +1,6 @@
 ---
 title: "GitLab CI/CD"
+description: "Use Bencher in GitLab CI/CD for continuous benchmarking on merge requests"
 heading: "How to use Bencher in GitLab CI/CD"
 sortOrder: 4
 ---
diff --git a/services/console/src/content/how_to/install-cli.mdx b/services/console/src/content/how_to/install-cli.mdx
index 1bbb2e673..fc13d50f6 100644
--- a/services/console/src/content/how_to/install-cli.mdx
+++ b/services/console/src/content/how_to/install-cli.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Install CLI"
+description: "Install the bencher CLI for use both locally and in continuous benchmarking"
 heading: "How to Install bencher CLI"
 sortOrder: 1
 ---
diff --git a/services/console/src/content/how_to/track-benchmarks.mdx b/services/console/src/content/how_to/track-benchmarks.mdx
index 920fff51c..2bfc2531f 100644
--- a/services/console/src/content/how_to/track-benchmarks.mdx
+++ b/services/console/src/content/how_to/track-benchmarks.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Track Benchmarks"
+description: "Catch code benchmark performance regressions with historical continuous benchmarking or relative continuous benchmarking"
 heading: "How to use Bencher to Track Benchmarks"
 sortOrder: 2
 ---
diff --git a/services/console/src/content/legal/license.mdx b/services/console/src/content/legal/license.mdx
index 5c5d69154..4afb06ea8 100644
--- a/services/console/src/content/legal/license.mdx
+++ b/services/console/src/content/legal/license.mdx
@@ -1,5 +1,6 @@
 ---
 title: "License Agreement"
+description: "The license agreement for the Bencher software"
 heading: "Bencher License Agreement"
 sortOrder: 3
 ---
diff --git a/services/console/src/content/legal/plus.mdx b/services/console/src/content/legal/plus.mdx
index 292bdc9e1..d1870ecab 100644
--- a/services/console/src/content/legal/plus.mdx
+++ b/services/console/src/content/legal/plus.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Plus License"
+description: "The license agreement for Bencher Plus software"
 heading: "Bencher Plus License"
 sortOrder: 5
 ---
diff --git a/services/console/src/content/legal/privacy.mdx b/services/console/src/content/legal/privacy.mdx
index 495e9660a..8034d1065 100644
--- a/services/console/src/content/legal/privacy.mdx
+++ b/services/console/src/content/legal/privacy.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Privacy Policy"
+description: "The privacy agreement for Bencher software and services"
 heading: "Bencher Privacy Policy"
 sortOrder: 2
 ---
diff --git a/services/console/src/content/legal/subscription.mdx b/services/console/src/content/legal/subscription.mdx
index 04a621d75..621dae1de 100644
--- a/services/console/src/content/legal/subscription.mdx
+++ b/services/console/src/content/legal/subscription.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Subscription Agreement"
+description: "The subscription agreement for Bencher software and services"
 heading: "Bencher Subscription Agreement"
 sortOrder: 4
 ---
diff --git a/services/console/src/content/legal/terms-of-use.mdx b/services/console/src/content/legal/terms-of-use.mdx
index 689f402f4..c9a4292ca 100644
--- a/services/console/src/content/legal/terms-of-use.mdx
+++ b/services/console/src/content/legal/terms-of-use.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Website Terms of Use"
+description: "The terms of use agreement for the Bencher website"
 heading: "Bencher Website Terms of Use"
 sortOrder: 1
 ---
diff --git a/services/console/src/content/reference/changelog.mdx b/services/console/src/content/reference/changelog.mdx
index 64c2bd5e1..a36fd96e1 100644
--- a/services/console/src/content/reference/changelog.mdx
+++ b/services/console/src/content/reference/changelog.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Changelog"
+description: "Bencher release changelog"
 heading: "Bencher Changelog"
 sortOrder: 4
 ---
diff --git a/services/console/src/content/reference/prior-art.mdx b/services/console/src/content/reference/prior-art.mdx
index da644744a..8aafaaa93 100644
--- a/services/console/src/content/reference/prior-art.mdx
+++ b/services/console/src/content/reference/prior-art.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Prior Art"
+description: "Collection of code benchmark tracking, comparison, and harness tools and documentation for continuous benchmarking"
 heading: "Prior Art"
 sortOrder: 2
 ---
diff --git a/services/console/src/content/reference/roadmap.mdx b/services/console/src/content/reference/roadmap.mdx
index 2e458695b..99e766f0c 100644
--- a/services/console/src/content/reference/roadmap.mdx
+++ b/services/console/src/content/reference/roadmap.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Roadmap"
+description: "Roadmap for Bencher continuous benchmarking suite"
 heading: "Bencher Roadmap"
 sortOrder: 3
 ---
diff --git a/services/console/src/content/reference/server-config.mdx b/services/console/src/content/reference/server-config.mdx
index 661927299..d0555d55e 100644
--- a/services/console/src/content/reference/server-config.mdx
+++ b/services/console/src/content/reference/server-config.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Server Config"
+description: "Bencher API server configuration for self-hosted continuous benchmarking"
 heading: "API Server Config"
 sortOrder: 1
 ---
@@ -74,30 +75,30 @@ Example JSON configuration:
 
 ## `console`
 
-| Name | Example                       | Default                 | Required | Description                                         |
-|:----:|:-----------------------------:|:-----------------------:|:--------:|:---------------------------------------------------:|
-| url  | "https://bencher.example.com" | "http://localhost:3000" | Yes      | Specifies the URL for the Bencher UI console host.  |
+| Name  |            Example            |         Default         | Required |                    Description                     |
+| :---: | :---------------------------: | :---------------------: | :------: | :------------------------------------------------: |
+|  url  | "https://bencher.example.com" | "http://localhost:3000" |   Yes    | Specifies the URL for the Bencher UI console host. |
 
 ## `security`
 
-| Name       | Example                                        | Default                 | Required | Description                                                                                                                                                                                                                                                                         |
-|:----------:|:----------------------------------------------:|:-----------------------:|:--------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
-| issuer     | "https://api.bencher.example.com"              | "bencher.dev"           | No       | Specifies the JSON Web Token (JWT) issuer. **WARNING** Changing this value will cause all previously generated JWTs to no longer validate.                                                                                                                                          |
-| secret_key | "UJu7Cpxb-zFaJYqXD-3mDDSDyj-ZvfxZFZs-X58xjxPy" | Random UUID v4          | Yes      | Specifies the the key used to generate all tokens. **IT SHOULD BE VERY SECURE!** The default value is a randomly generated [UUID v4](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random)). Whenever logged, it will appear obfuscated as `************`. |
+|    Name    |                    Example                     |    Default     | Required |                                                                                                                                     Description                                                                                                                                     |
+| :--------: | :--------------------------------------------: | :------------: | :------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
+|   issuer   |       "https://api.bencher.example.com"        | "bencher.dev"  |    No    |                                                                     Specifies the JSON Web Token (JWT) issuer. **WARNING** Changing this value will cause all previously generated JWTs to no longer validate.                                                                      |
+| secret_key | "UJu7Cpxb-zFaJYqXD-3mDDSDyj-ZvfxZFZs-X58xjxPy" | Random UUID v4 |   Yes    | Specifies the the key used to generate all tokens. **IT SHOULD BE VERY SECURE!** The default value is a randomly generated [UUID v4](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random)). Whenever logged, it will appear obfuscated as `************`. |
 
 # `server`
 
 This section is based on the [Dropshot server configuration](https://github.com/oxidecomputer/dropshot/tree/v0.9.0#dropshot-servers).
 
-| Name                   | Example                         | Default         | Required                    | Description                                                                                                                                                                                                                                                                                                 |
-|:----------------------:|:-------------------------------:|:---------------:|:---------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
-| bind_address           | "0.0.0.0:61016"                 | "0.0.0.0:61016" | Yes                         | Specifies that the server should bind to the given IP address and TCP port. In general, servers can bind to more than one IP address and port, but this is not (yet?) supported. Defaults to "127.0.0.1:0".                                                                                                 |
-| request_body_max_bytes | 1048576                         | 1048576         | Yes                         | Specifies the maximum number of bytes allowed in a request body. Larger requests will receive a 400 error. Defaults to 1024.                                                                                                                                                                                |
-| tls.type               | "as_file"                       | ---             | No                          | Specifies if and how TLS certificate and key information is provided. Valid values include "as_file" and "as_bytes".                                                                                                                                                                                        |
-| tls.cert_file          | "/path/to/cert.pem"             | ---             | Only if tls.type = as_file  | Specifies the path to a PEM file containing a  certificate chain for the server to identify itself with. The first certificate is the end-entity certificate, and the remaining are intermediate certificates on the way to a trusted CA. If specified, the server will only listen for TLS connections.    |
-| tls.key_file           | "/path/to/key.pem"              | ---             | Only if tls.type = as_file  | Specifies the path to a PEM-encoded PKCS #8 file containing the private key the server will use. If specified, the server will only listen for TLS connections.                                                                                                                                             |
-| tls.certs              | ---                             | ---             | Only if tls.type = as_bytes | Identical to tls.cert_file, but provided as an array of bytes of certificate data.                                                                                                                                                                                                                          |
-| tls.key                | ---                             | ---             | Only if tls.type = as_bytes | Identical to tls.key_file, but provided as an array of bytes of key data.                                                                                                                                                                                                                                   |
+|          Name          |       Example       |     Default     |          Required           |                                                                                                                                               Description                                                                                                                                                |
+| :--------------------: | :-----------------: | :-------------: | :-------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
+|      bind_address      |   "0.0.0.0:61016"   | "0.0.0.0:61016" |             Yes             |                                               Specifies that the server should bind to the given IP address and TCP port. In general, servers can bind to more than one IP address and port, but this is not (yet?) supported. Defaults to "127.0.0.1:0".                                                |
+| request_body_max_bytes |       1048576       |     1048576     |             Yes             |                                                                                       Specifies the maximum number of bytes allowed in a request body. Larger requests will receive a 400 error. Defaults to 1024.                                                                                       |
+|        tls.type        |      "as_file"      |       ---       |             No              |                                                                                           Specifies if and how TLS certificate and key information is provided. Valid values include "as_file" and "as_bytes".                                                                                           |
+|     tls.cert_file      | "/path/to/cert.pem" |       ---       | Only if tls.type = as_file  | Specifies the path to a PEM file containing a  certificate chain for the server to identify itself with. The first certificate is the end-entity certificate, and the remaining are intermediate certificates on the way to a trusted CA. If specified, the server will only listen for TLS connections. |
+|      tls.key_file      | "/path/to/key.pem"  |       ---       | Only if tls.type = as_file  |                                                                     Specifies the path to a PEM-encoded PKCS #8 file containing the private key the server will use. If specified, the server will only listen for TLS connections.                                                                      |
+|       tls.certs        |         ---         |       ---       | Only if tls.type = as_bytes |                                                                                                            Identical to tls.cert_file, but provided as an array of bytes of certificate data.                                                                                                            |
+|        tls.key         |         ---         |       ---       | Only if tls.type = as_bytes |                                                                                                                Identical to tls.key_file, but provided as an array of bytes of key data.                                                                                                                 |
 
 
 
@@ -105,24 +106,24 @@ This section is based on the [Dropshot server configuration](https://github.com/
 
 This section is based on the [Dropshot logging configuration](https://github.com/oxidecomputer/dropshot/tree/v0.9.0#logging).
 
-| Name          | Example           | Default           | Required                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                      |
-|:-------------:|:-----------------:|:-----------------:|:-------------------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
-| name          | "Bencher API"     | "Bencher API"     | Yes                       | Specifies the name of the logger.                                                                                                                                                                                                                                                                                                                                                                                                |
-| log.mode      | "stderr_terminal" | "stderr_terminal" | Yes                       | Controls where server logging will go. Valid modes are "stderr-terminal" and "file". If the mode is `"stderr-terminal", human-readable output, with colors and other terminal formatting if possible, will be sent to stderr. If the mode is "file", Bunyan-format output will be sent to the filesystem path given by log.path. See also log.if_exists, which controls the behavior if the destination path already exists.     |
-| log.level     | "info"            | "info"            | Yes                       | Specifies what severity of log messages should be included in the log. Valid values include "trace", "debug", "info", "warn", "error", and "critical", which are increasing order of severity. Log messages at the specified level and more severe levels will be included in the log.                                                                                                                                           |
-| log.path      | ---               | ---               | Only if log.mode = "file" | If log.mode is "file", this property determines the path to the log file. See also log.if_exists.                                                                                                                                                                                                                                                                                                                                |
-| log.if_exists | ---               | ---               | Only if log.mode = "file" | If log.mode is "file", this property specifies what to do if the destination log file already exists. Valid values include "append" (which appends to the existing file), "truncate" (which truncates the existing file and then uses it as though it had just been created), and "fail" (which causes the server to exit immediately with an error).                                                                            |
+|     Name      |      Example      |      Default      |         Required          |                                                                                                                                                                                                         Description                                                                                                                                                                                                          |
+| :-----------: | :---------------: | :---------------: | :-----------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
+|     name      |   "Bencher API"   |   "Bencher API"   |            Yes            |                                                                                                                                                                                              Specifies the name of the logger.                                                                                                                                                                                               |
+|   log.mode    | "stderr_terminal" | "stderr_terminal" |            Yes            | Controls where server logging will go. Valid modes are "stderr-terminal" and "file". If the mode is `"stderr-terminal", human-readable output, with colors and other terminal formatting if possible, will be sent to stderr. If the mode is "file", Bunyan-format output will be sent to the filesystem path given by log.path. See also log.if_exists, which controls the behavior if the destination path already exists. |
+|   log.level   |      "info"       |      "info"       |            Yes            |                                                                    Specifies what severity of log messages should be included in the log. Valid values include "trace", "debug", "info", "warn", "error", and "critical", which are increasing order of severity. Log messages at the specified level and more severe levels will be included in the log.                                                                    |
+|   log.path    |        ---        |        ---        | Only if log.mode = "file" |                                                                                                                                                              If log.mode is "file", this property determines the path to the log file. See also log.if_exists.                                                                                                                                                               |
+| log.if_exists |        ---        |        ---        | Only if log.mode = "file" |                                    If log.mode is "file", this property specifies what to do if the destination log file already exists. Valid values include "append" (which appends to the existing file), "truncate" (which truncates the existing file and then uses it as though it had just been created), and "fail" (which causes the server to exit immediately with an error).                                     |
 
 
 ## `database`
 
-| Name                         | Example                                                                       | Default           | Required                              | Description                                                                                                                                                                                      |
-|:----------------------------:|:-----------------------------------------------------------------------------:|:-----------------:|:-------------------------------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
-| file                         | "path/to/database.db"                                                         | "data/bencher.db" | Yes                                   | Controls where server database will go.                                                                                                                                                          |
-| data_store.service           | "aws_s3"                                                                      | ---               | No                                    | Specifies the remote data store service. Valid values are "aws_s3".                                                                                                                              |
-| data_store.access_key_id     | "ABC123DoRemMiABC123"                                                         | ---               | Only if data_store.service = "aws_s3" | If data_store.service = "aws_s3", this property specifies the AWS access key ID. See also data_store.service.                                                                                    |
-| data_store.secret_access_key | "AA3Chr-JSF5sUQqKwayx-FvCfZKsMev-5BqPpcFC3m7"                                 | ---               | Only if data_store.service = "aws_s3" | If data_store.service = "aws_s3", this property specifies the AWS secret access key. See also data_store.service. Whenever logged, it will appear obfuscated as `************`.                  |
-| data_store.access_point      | "arn:aws:s3:some-region-1:123456789:accesspoint/my-bucket/path/to/backup/dir" | ---               | Only if data_store.service = "aws_s3" | If data_store.service = "aws_s3", this property specifies the [AWS S3 accesspoint](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html). See also data_store.service. |
+|             Name             |                                    Example                                    |      Default      |               Required                |                                                                                           Description                                                                                            |
+| :--------------------------: | :---------------------------------------------------------------------------: | :---------------: | :-----------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
+|             file             |                             "path/to/database.db"                             | "data/bencher.db" |                  Yes                  |                                                                             Controls where server database will go.                                                                              |
+|      data_store.service      |                                   "aws_s3"                                    |        ---        |                  No                   |                                                               Specifies the remote data store service. Valid values are "aws_s3".                                                                |
+|   data_store.access_key_id   |                             "ABC123DoRemMiABC123"                             |        ---        | Only if data_store.service = "aws_s3" |                                          If data_store.service = "aws_s3", this property specifies the AWS access key ID. See also data_store.service.                                           |
+| data_store.secret_access_key |                 "AA3Chr-JSF5sUQqKwayx-FvCfZKsMev-5BqPpcFC3m7"                 |        ---        | Only if data_store.service = "aws_s3" |         If data_store.service = "aws_s3", this property specifies the AWS secret access key. See also data_store.service. Whenever logged, it will appear obfuscated as `************`.          |
+|   data_store.access_point    | "arn:aws:s3:some-region-1:123456789:accesspoint/my-bucket/path/to/backup/dir" |        ---        | Only if data_store.service = "aws_s3" | If data_store.service = "aws_s3", this property specifies the [AWS S3 accesspoint](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html). See also data_store.service. |
 
 ## `smtp`
 
@@ -130,20 +131,20 @@ This section specifies an [SMTP](https://en.wikipedia.org/wiki/Simple_Mail_Trans
 The entire section is optional.
 If not specified, all messages will be sent to `logging` instead.
 
-| Name       | Example                    | Default | Required | Description                                                                                                           |
-|:----------:|:--------------------------:|:-------:|:--------:|:---------------------------------------------------------------------------------------------------------------------:|
-| hostname   | "mailbonobo.com"           | ---     | Yes      | Specifies the SMTP hostname.                                                                                          |
-| port       | 587                        | 587     | No       | Specifies the SMTP port.                                                                                              |
-| starttls   | true                       | true    | No       | Controls whether the SMTP connection uses the STARTTLS protocol.                                                      |
-| username   | "bencher"                  | ---     | Yes      | Specifies the username at the SMTP host.                                                                              |
-| secret     | "WM3F2u9cqSNdBPLfy9sJ5kk9" | ---     | Yes      | Specifies the secret for the username at the SMTP host. Whenever logged, it will appear obfuscated as `************`. |
-| from_name  | "Bencher"                  | ---     | Yes      | Specifies the name that will appear in the from section of all emails.                                                |
-| from_email | "info@bencher.example.com" | ---     | Yes      | Spefifies the email that will appear in the from section of all emails.                                               |
+|    Name    |          Example           | Default | Required |                                                      Description                                                      |
+| :--------: | :------------------------: | :-----: | :------: | :-------------------------------------------------------------------------------------------------------------------: |
+|  hostname  |      "mailbonobo.com"      |   ---   |   Yes    |                                             Specifies the SMTP hostname.                                              |
+|    port    |            587             |   587   |    No    |                                               Specifies the SMTP port.                                                |
+|  starttls  |            true            |  true   |    No    |                           Controls whether the SMTP connection uses the STARTTLS protocol.                            |
+|  username  |         "bencher"          |   ---   |   Yes    |                                       Specifies the username at the SMTP host.                                        |
+|   secret   | "WM3F2u9cqSNdBPLfy9sJ5kk9" |   ---   |   Yes    | Specifies the secret for the username at the SMTP host. Whenever logged, it will appear obfuscated as `************`. |
+| from_name  |         "Bencher"          |   ---   |   Yes    |                        Specifies the name that will appear in the from section of all emails.                         |
+| from_email | "info@bencher.example.com" |   ---   |   Yes    |                        Spefifies the email that will appear in the from section of all emails.                        |
 
 ## `apm`
 
 Application Performance Monitoring (APM) is a feature that allows the Bencher API Server to send telemetry to a third-party service.
 
-| Name       | Example                                                           | Default | Required | Description                                                                                                                                         |
-|:----------:|:-----------------------------------------------------------------:|:-------:|:--------:|:---------------------------------------------------------------------------------------------------------------------------------------------------:|
-| sentry.dsn | "https://0123abc1023abc@987efg987efg.ingest.sentry.io/0123456789" | ---     | No       | Sentry [Data Source Name](https://docs.sentry.io/product/sentry-basics/dsn-explainer/). Can also be set with the `SENTRY_DSN` environment variable. |
\ No newline at end of file
+|    Name    |                              Example                              | Default | Required |                                                                     Description                                                                     |
+| :--------: | :---------------------------------------------------------------: | :-----: | :------: | :-------------------------------------------------------------------------------------------------------------------------------------------------: |
+| sentry.dsn | "https://0123abc1023abc@987efg987efg.ingest.sentry.io/0123456789" |   ---   |    No    | Sentry [Data Source Name](https://docs.sentry.io/product/sentry-basics/dsn-explainer/). Can also be set with the `SENTRY_DSN` environment variable. |
\ No newline at end of file
diff --git a/services/console/src/content/tutorial/docker.mdx b/services/console/src/content/tutorial/docker.mdx
index 56680f758..4ffa966d6 100644
--- a/services/console/src/content/tutorial/docker.mdx
+++ b/services/console/src/content/tutorial/docker.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Docker Self-Hosted"
+description: "Learn how to setup self-hosted continuous benchmarking with Bencher"
 heading: "Docker Self-Hosted"
 sortOrder: 2
 ---
diff --git a/services/console/src/content/tutorial/quick-start.mdx b/services/console/src/content/tutorial/quick-start.mdx
index 01d951b53..d18eb10ea 100644
--- a/services/console/src/content/tutorial/quick-start.mdx
+++ b/services/console/src/content/tutorial/quick-start.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Quick Start"
+description: "Learn how to setup continuous benchmarking with Bencher Cloud"
 heading: "Quick Start"
 sortOrder: 1
 ---
diff --git a/services/console/src/layouts/BaseLayout.astro b/services/console/src/layouts/BaseLayout.astro
index f58dcc0c6..8432f268c 100644
--- a/services/console/src/layouts/BaseLayout.astro
+++ b/services/console/src/layouts/BaseLayout.astro
@@ -9,16 +9,16 @@ import { BENCHER_LOGO_URL } from "../util/ext";
 
 interface Props {
   title: string;
+  titleFmt?: undefined | ((title: string) => string);
   description: string;
 }
 
 // https://docs.astro.build/en/reference/directives-reference/#definevars
 const PUBLIC_GOOGLE_ANALYTICS_ID = import.meta.env.PUBLIC_GOOGLE_ANALYTICS_ID;
-const { title, description } = Astro.props;
-
+const { title, titleFmt, description } = Astro.props;
 ---
 
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
@@ -28,6 +28,7 @@ const { title, description } = Astro.props;
     />
     <meta name="theme-color" content="#ffffff" />
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="sitemap" href="/sitemap-index.xml" />
     <meta name="generator" content={Astro.generator} />
     <SEO
       title={title}
@@ -36,43 +37,36 @@ const { title, description } = Astro.props;
       description={description ?? BENCHER_DESCRIPTION}
       openGraph={{
         basic: {
-          title: title,
+          title: titleFmt ? titleFmt(title) : title,
           type: "website",
           image: BENCHER_LOGO_URL,
         },
         optional: {
-          siteName: "Bencher",
+          siteName: "🐰 Bencher",
           description: description ?? BENCHER_DESCRIPTION,
-        }
+        },
       }}
       twitter={{
-        creator: "@bencherdev"
+        creator: "@bencherdev",
       }}
     />
-    <!-- https://devicon.dev/ -->
     <link
       rel="preload"
       href="https://cdn.jsdelivr.net/gh/devicons/devicon@v2.15.1/devicon.min.css"
       as="style"
-      onload="
-      this.onload = null; this.rel = 'stylesheet'
-      "
+      onload="this.onload = null; this.rel = 'stylesheet'"
     />
-    <noscript>
-      <link
-        rel="stylesheet"
-        href="https://cdn.jsdelivr.net/gh/devicons/devicon@v2.15.1/devicon.min.css"
-      />
-    </noscript>
-    <!-- font awesome -->
-    <script defer src="https://use.fontawesome.com/releases/v5.15.4/js/all.js"
+    <script
+      defer src="https://use.fontawesome.com/releases/v5.15.4/js/all.js"
     ></script>
-    <!-- Google tag (gtag.js) -->
     <script
       type="text/partytown"
       src={`https://www.googletagmanager.com/gtag/js?id=${PUBLIC_GOOGLE_ANALYTICS_ID}`}
     ></script>
-    <script define:vars={{ PUBLIC_GOOGLE_ANALYTICS_ID }} type="text/partytown">
+    <script
+      define:vars={{ PUBLIC_GOOGLE_ANALYTICS_ID }}
+      type="text/partytown"
+    >
       window.dataLayer = window.dataLayer || [];
       function gtag() {
         dataLayer.push(arguments);
@@ -80,8 +74,9 @@ const { title, description } = Astro.props;
       gtag("js", new Date());
       gtag("config", PUBLIC_GOOGLE_ANALYTICS_ID);
     </script>
-    <!-- <ViewTransitions /> -->
   </head>
+  <!-- <ViewTransitions /> -->
+
   <body>
     <slot name="navbar">
       <Navbar client:load />
diff --git a/services/console/src/layouts/docs/DocsLayout.astro b/services/console/src/layouts/docs/DocsLayout.astro
index 1513d0148..b3dd43190 100644
--- a/services/console/src/layouts/docs/DocsLayout.astro
+++ b/services/console/src/layouts/docs/DocsLayout.astro
@@ -5,13 +5,18 @@ import DocsMenu from "../../components/docs/DocsMenu.astro";
 
 interface Props {
   title: string;
+  description: string;
   heading?: string;
 }
 
-const { title, heading } = Astro.props;
+const { title, description, heading } = Astro.props;
 ---
 
-<BaseLayout title={title}>
+<BaseLayout
+  title={title}
+  titleFmt={(title) => `📖 ${title}`}
+  description={description}
+>
   <!-- Note that the AuthNavbar does *not* fill the slot `navbar`. It is a client-side override.  -->
   <AuthNavbar client:only />
   <div class="is-widescreen">
diff --git a/services/console/src/layouts/legal/LegalLayout.astro b/services/console/src/layouts/legal/LegalLayout.astro
index 01b00eb9b..97c2f9c11 100644
--- a/services/console/src/layouts/legal/LegalLayout.astro
+++ b/services/console/src/layouts/legal/LegalLayout.astro
@@ -4,13 +4,18 @@ import BaseLayout from "../BaseLayout.astro";
 
 interface Props {
   title: string;
+  description: string;
   heading: string;
 }
 
-const { title, heading } = Astro.props;
+const { title, description, heading } = Astro.props;
 ---
 
-<BaseLayout title={title}>
+<BaseLayout
+  title={title}
+  titleFmt={(title) => `⚖️ ${title}`}
+  description={description}
+>
   <!-- Note that the AuthNavbar does *not* fill the slot `navbar`. It is a client-side override.  -->
   <AuthNavbar client:only />
   <section class="section">
diff --git a/services/console/src/layouts/perf/PerfLayout.astro b/services/console/src/layouts/perf/PerfLayout.astro
index 3bde3d325..b1d0ebce2 100644
--- a/services/console/src/layouts/perf/PerfLayout.astro
+++ b/services/console/src/layouts/perf/PerfLayout.astro
@@ -4,12 +4,14 @@ import AuthNavbar from "../../components/site/navbar/AuthNavbar";
 
 interface Props {
   title: string;
+  titleFmt?: (title: string) => string;
+  description: string;
 }
 
-const { title } = Astro.props;
+const { title, titleFmt, description } = Astro.props;
 ---
 
-<BaseLayout title={title}>
+<BaseLayout title={title} titleFmt={titleFmt} description={description}>
   <!-- Note that the AuthNavbar does *not* fill the slot `navbar`. It is a client-side override.  -->
   <AuthNavbar client:only />
   <slot />
diff --git a/services/console/src/pages/404.astro b/services/console/src/pages/404.astro
index e73b2469a..42d5f88d5 100644
--- a/services/console/src/pages/404.astro
+++ b/services/console/src/pages/404.astro
@@ -3,6 +3,10 @@ import Help from "../components/console/help/Help";
 import LegalLayout from "../layouts/legal/LegalLayout.astro";
 ---
 
-<LegalLayout title="Not Found" heading="404: Not Found">
+<LegalLayout
+  title="Not Found"
+  description="Whoops! Page not found 🙃"
+  heading="404: Not Found"
+>
   <Help client:only />
 </LegalLayout>
diff --git a/services/console/src/pages/docs/explanation/[slug].astro b/services/console/src/pages/docs/explanation/[slug].astro
index 53179e7f3..100ad4f03 100644
--- a/services/console/src/pages/docs/explanation/[slug].astro
+++ b/services/console/src/pages/docs/explanation/[slug].astro
@@ -14,6 +14,10 @@ const { page } = Astro.props;
 const { Content } = await page.render();
 ---
 
-<DocsLayout title={page.data.title} heading={page.data.heading}>
+<DocsLayout
+  title={page.data.title}
+  description={page.data.description}
+  heading={page.data.heading}
+>
   <Content />
 </DocsLayout>
diff --git a/services/console/src/pages/docs/how-to/[slug].astro b/services/console/src/pages/docs/how-to/[slug].astro
index 918c05576..03984a445 100644
--- a/services/console/src/pages/docs/how-to/[slug].astro
+++ b/services/console/src/pages/docs/how-to/[slug].astro
@@ -14,6 +14,10 @@ const { page } = Astro.props;
 const { Content } = await page.render();
 ---
 
-<DocsLayout title={page.data.title} heading={page.data.heading}>
+<DocsLayout
+  title={page.data.title}
+  description={page.data.description}
+  heading={page.data.heading}
+>
   <Content />
 </DocsLayout>
diff --git a/services/console/src/pages/docs/index.astro b/services/console/src/pages/docs/index.astro
index 520d8bbb8..212dc5bb8 100644
--- a/services/console/src/pages/docs/index.astro
+++ b/services/console/src/pages/docs/index.astro
@@ -15,9 +15,11 @@ const reference = await getCollection("reference");
 reference.sort((a, b) => a.data.sortOrder - b.data.sortOrder);
 
 const title = "Bencher Docs";
+const description =
+  "Table of contents for the Bencher documentation. Learn how to setup continuous benchmarking for your project.";
 ---
 
-<DocsLayout title={title} heading={title}>
+<DocsLayout title={title} description={description} heading={title}>
   <div class="menu">
     <p class="menu-label">Tutorial</p>
     <ul class="menu-list">
diff --git a/services/console/src/pages/docs/reference/[slug].astro b/services/console/src/pages/docs/reference/[slug].astro
index 067c71d5d..eba0c4abb 100644
--- a/services/console/src/pages/docs/reference/[slug].astro
+++ b/services/console/src/pages/docs/reference/[slug].astro
@@ -14,6 +14,10 @@ const { page } = Astro.props;
 const { Content } = await page.render();
 ---
 
-<DocsLayout title={page.data.title} heading={page.data.heading}>
+<DocsLayout
+  title={page.data.title}
+  description={page.data.description}
+  heading={page.data.heading}
+>
   <Content />
 </DocsLayout>
diff --git a/services/console/src/pages/docs/reference/api.astro b/services/console/src/pages/docs/reference/api.astro
index 51b3cf918..c7226f00a 100644
--- a/services/console/src/pages/docs/reference/api.astro
+++ b/services/console/src/pages/docs/reference/api.astro
@@ -6,8 +6,9 @@ import SwaggerPanel from "../../../components/docs/SwaggerPanel";
 
 const BENCHER_API_URL = import.meta.env.BENCHER_API_URL;
 const title = "REST API";
+const description = "The REST API for continuous benchmarking with Bencher";
 ---
 
-<DocsLayout title={title}>
+<DocsLayout title={title} description={description}>
   <SwaggerPanel client:only apiUrl={BENCHER_API_URL} />
 </DocsLayout>
diff --git a/services/console/src/pages/docs/reference/architecture.astro b/services/console/src/pages/docs/reference/architecture.astro
index 76e299a82..fdf52b5a2 100644
--- a/services/console/src/pages/docs/reference/architecture.astro
+++ b/services/console/src/pages/docs/reference/architecture.astro
@@ -2,10 +2,11 @@
 import DocsLayout from "../../../layouts/docs/DocsLayout.astro";
 
 const title = "Architecture";
+const description = "Diagram of the Bencher Architecture";
 const heading = "Bencher Architecture";
 ---
 
-<DocsLayout title={title} heading={heading}>
+<DocsLayout title={title} description={description} heading={heading}>
   <pre
     class="mermaid">
     graph TD
diff --git a/services/console/src/pages/docs/tutorial/[slug].astro b/services/console/src/pages/docs/tutorial/[slug].astro
index d1fa732b6..5b53b6f69 100644
--- a/services/console/src/pages/docs/tutorial/[slug].astro
+++ b/services/console/src/pages/docs/tutorial/[slug].astro
@@ -14,6 +14,10 @@ const { page } = Astro.props;
 const { Content } = await page.render();
 ---
 
-<DocsLayout title={page.data.title} heading={page.data.heading}>
+<DocsLayout
+  title={page.data.title}
+  description={page.data.description}
+  heading={page.data.heading}
+>
   <Content />
 </DocsLayout>
diff --git a/services/console/src/pages/docs/tutorial/quick-start.astro b/services/console/src/pages/docs/tutorial/quick-start.astro
index 85793a3e9..0c62fe7f8 100644
--- a/services/console/src/pages/docs/tutorial/quick-start.astro
+++ b/services/console/src/pages/docs/tutorial/quick-start.astro
@@ -11,6 +11,7 @@ const tokenId = "add-an-api-token";
 
 <DocsLayout
   title={quickStart.frontmatter.title}
+  description={quickStart.frontmatter.description}
   heading={quickStart.frontmatter.heading}
 >
   <Content />
diff --git a/services/console/src/pages/help.astro b/services/console/src/pages/help.astro
index b4235979e..05bf10232 100644
--- a/services/console/src/pages/help.astro
+++ b/services/console/src/pages/help.astro
@@ -6,9 +6,11 @@ import Help from "../components/console/help/Help";
 import HelpRedirect from "../components/console/help/HelpRedirect";
 
 const title = "Help";
+const titleFmt = (title: string) => `🛟 ${title}`;
+const description = "Get help with Bencher and continuous benchmarking";
 ---
 
-<BaseLayout title={title}>
+<BaseLayout title={title} titleFmt={titleFmt} description={description}>
   <HelpRedirect client:only />
   <Help client:only />
 </BaseLayout>
diff --git a/services/console/src/pages/index.astro b/services/console/src/pages/index.astro
index 1a5075ee6..9100721ae 100644
--- a/services/console/src/pages/index.astro
+++ b/services/console/src/pages/index.astro
@@ -4,11 +4,14 @@ import BaseLayout from "../layouts/BaseLayout.astro";
 import Toolbox from "../components/landing/Toolbox";
 import { BENCHER_CALENDLY_URL } from "../util/ext";
 import AuthRedirect from "../components/auth/AuthRedirect";
-
-const title = "";
+import { BENCHER_DESCRIPTION, BENCHER_TITLE } from "../util/resource";
 ---
 
-<BaseLayout title={title}>
+<BaseLayout
+  title={BENCHER_TITLE}
+  titleFmt={(title: string) => `🐰 ${title}`}
+  description={BENCHER_DESCRIPTION}
+>
   <AuthRedirect client:only path="/console/organizations" />
   <section class="section is-medium">
     <div class="container">
@@ -94,8 +97,9 @@ const title = "";
                 <div class="content">
                   <p>
                     Run your benchmarks locally or in CI using your favorite
-                    benchmarking tools. The <code>bencher</code> CLI simply wraps
-                    your existing benchmark harness and stores its results.
+                    benchmarking tools. The <code>bencher</code> CLI simply
+                    wraps your existing benchmark harness and stores its
+                    results.
                   </p>
                   <br />
                 </div>
diff --git a/services/console/src/pages/legal/[slug].astro b/services/console/src/pages/legal/[slug].astro
index dbeed942d..b914f0c58 100644
--- a/services/console/src/pages/legal/[slug].astro
+++ b/services/console/src/pages/legal/[slug].astro
@@ -14,6 +14,10 @@ const { page } = Astro.props;
 const { Content } = await page.render();
 ---
 
-<LegalLayout title={page.data.title} heading={page.data.heading}>
+<LegalLayout
+  title={page.data.title}
+  description={page.data.description}
+  heading={page.data.heading}
+>
   <Content />
 </LegalLayout>
diff --git a/services/console/src/pages/legal/index.astro b/services/console/src/pages/legal/index.astro
index 97787afe1..6e9bb1bbf 100644
--- a/services/console/src/pages/legal/index.astro
+++ b/services/console/src/pages/legal/index.astro
@@ -6,7 +6,11 @@ const pages = await getCollection("legal");
 pages.sort((a, b) => a.data.sortOrder - b.data.sortOrder);
 ---
 
-<LegalLayout title="Legal" heading="Bencher Legal">
+<LegalLayout
+  title="Legal"
+  description="Legal terms and conditions for Bencher software and services"
+  heading="Bencher Legal"
+>
   <ul>
     {
       pages.map((page) => (
diff --git a/services/console/src/pages/perf/[project].astro b/services/console/src/pages/perf/[project].astro
index 4221f9f65..9e907cde0 100644
--- a/services/console/src/pages/perf/[project].astro
+++ b/services/console/src/pages/perf/[project].astro
@@ -9,6 +9,9 @@ const params = Astro.params;
 const title = "Project Perf";
 ---
 
-<PerfLayout title={title}>
+<PerfLayout
+  title={title}
+  description="View benchmark performance of this public project on Bencher"
+>
   <PublicProject client:only apiUrl={BENCHER_API_URL} params={params} />
 </PerfLayout>
diff --git a/services/console/src/pages/perf/index.astro b/services/console/src/pages/perf/index.astro
index e1a09a308..4f218bfa3 100644
--- a/services/console/src/pages/perf/index.astro
+++ b/services/console/src/pages/perf/index.astro
@@ -8,6 +8,10 @@ const BENCHER_API_URL = import.meta.env.BENCHER_API_URL;
 const title = "Bencher Projects";
 ---
 
-<PerfLayout title={title}>
+<PerfLayout
+  title={title}
+  titleFmt={(title) => `📈 ${title}`}
+  description="View benchmark performance of public projects on Bencher"
+>
   <PublicProjects client:only apiUrl={BENCHER_API_URL} />
 </PerfLayout>
diff --git a/services/console/src/pages/pricing.astro b/services/console/src/pages/pricing.astro
index 266fb99ef..55318081f 100644
--- a/services/console/src/pages/pricing.astro
+++ b/services/console/src/pages/pricing.astro
@@ -3,9 +3,14 @@ import BaseLayout from "../layouts/BaseLayout.astro";
 import PricingTable from "../components/pricing/PricingTable";
 import { BENCHER_CALENDLY_URL } from "../util/ext";
 import AuthRedirect from "../components/auth/AuthRedirect";
+
+const title = "Pricing";
+const titleFmt = (title: string) => `🐰 ${title}`;
+const description =
+  "Free for all public projects. Use Bencher to setup continuous benchmarking today!";
 ---
 
-<BaseLayout title="Pricing">
+<BaseLayout title={title} titleFmt={titleFmt} description={description}>
   <AuthRedirect client:only path="/console/organizations?plan=team" />
   <div>
     <section class="hero">
@@ -56,8 +61,8 @@ import AuthRedirect from "../components/auth/AuthRedirect";
               <a href="/perf" target="_blank" rel="noreferrer">
                 all Public Projects are available here
               </a>
-              . If you are using Bencher Self-Hosted, then anyone with access to
-              your network will likewise be able to see all Public Projects.
+               . If you are using Bencher Self-Hosted, then anyone with access
+              to your network will likewise be able to see all Public Projects.
             </p>
           </div>
         </div>
@@ -174,9 +179,9 @@ import AuthRedirect from "../components/auth/AuthRedirect";
           >
             open core
           </a>{" "}
-          business model and generate almost all our revenue with subscriptions to
-          paid tiers. We recognize that we must balance the need to generate income
-          with the needs of the open source project.
+           business model and generate almost all our revenue with subscriptions
+          to paid tiers. We recognize that we must balance the need to generate
+          income with the needs of the open source project.
           <h3 class="title">Commitments</h3>
           <ul>
             <li>