OctopusDeploy · samironsoctopus · May 18, 2026 · May 18, 2026 · May 18, 2026 · May 18, 2026
diff --git a/.gitignore b/.gitignore
@@ -36,4 +36,15 @@ _site/
 *.iml
 **/*.dia~
 tmp
-.pnpm-store/
+.pnpm-store/
+
+# Local Claude Code context — not for commit
+CLAUDE.local.md
+.claude/
+
+# Local audit working files — not for commit
+/audit/
+*.audit.csv
+
+# Local writing guides and skills — not for commit
+octopus-writing-guide.md
diff --git a/public/docs/img/octopus-logo.png b/public/docs/img/octopus-logo.png
diff --git a/src/config.ts b/src/config.ts
@@ -56,6 +56,18 @@ export const OPEN_GRAPH = {
   },
 };
 
+// Schema.org inputs for JsonLd.astro. Set enabled=false to suppress
+// JSON-LD site-wide without a deploy revert. Logo asset existence is
+// not verified at build time.
+export const STRUCTURED_DATA = {
+  enabled: true,
+  organizationLogo: {
+    src: `${SITE.subfolder}/img/octopus-logo.png`,
+    width: 140,
+    height: 140,
+  },
+};
+
 export const HEADER_SCRIPTS = `
 	<link href="/docs/css/fa/css/fontawesome.css" rel="stylesheet">
 	<link href="/docs/css/fa/css/brands.css" rel="stylesheet">

diff --git a/src/pages/docs/getting-started/first-deployment/add-deployment-targets.mdx b/src/pages/docs/getting-started/first-deployment/add-deployment-targets.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2025-01-07
-title: Add deployment targets
-description: Step by step guide on how to add deployment targets in Octopus Deploy.
+title: Add deployment targets in Octopus Deploy
+description: Register machines or cloud services as deployment targets in Octopus Deploy. Follow the step-by-step guide to connect your first target and start deploying.
 navOrder: 70
 hideInThisSection: true
 ---
@@ -27,9 +27,9 @@
 ![Deployment Targets page](/docs/img/getting-started/first-deployment/images/deployment-targets-page.png)
 :::

 2. Click **Add Deployment Target**.
 3. Use the category tabs to filter by deployment target type.
 4. Click **Add** on the deployment target you want to add.

 ### Name

@@ -39,13 +39,13 @@

 We’ll scope this deployment target to one environment. Later, you can add additional targets and scope them to your other environments.

 5. Select **Development** from the **Environments** dropdown list.

 ### Target Tags

 Octopus uses target tags to select which deployment target a project should deploy to. Later, you’ll add the same target tag to your deployment process. You can deploy to multiple targets simply by adding this tag.

 6. Add a new target tag by typing it into the field. For this example, we’ll use `tutorial-target`.

 :::figure
 ![Deployment target form](/docs/img/getting-started/first-deployment/images/deployment-target-form.png)

diff --git a/...es/docs/getting-started/first-deployment/approvals-with-manual-interventions.md b/...es/docs/getting-started/first-deployment/approvals-with-manual-interventions.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2025-01-07
-title: Approvals with Manual Interventions
-description: Step by step guide on how to use Manual Interventions in Octopus Deploy for approvals
+title: Approvals with manual interventions
+description: Add a manual intervention step to require sign-off before each Octopus Deploy deployment proceeds. Follow the step-by-step guide to configure approvals.
 navOrder: 60
 hideInThisSection: true
 ---
@@ -27,20 +27,20 @@

 ### Instructions

 5. Copy the message below and paste it into the **Instructions** field.

 ```
 Please verify the Production environment is ready before proceeding.
 ```

 ### Responsible Teams

 6. Select **Octopus Administrators** and **Octopus Managers** from the **Responsible Teams** dropdown list.

 ### Environments

 7. Select **Run only for specific environments**.
 8. Select **Production** from the **Environments** dropdown list.

 You can skip the other sections of this page for this tutorial.


diff --git a/src/pages/docs/getting-started/first-deployment/define-and-use-variables.md b/src/pages/docs/getting-started/first-deployment/define-and-use-variables.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-11-13
-title: Define and use variables
-description: This tutorial will walk you through defining and using variables in an Octopus Deploy deployment.
+title: Define and use variables in Octopus Deploy
+description: Add variables to your Octopus Deploy project to make deployments flexible. Define variable values per environment and reference them in your deployment steps.
 navOrder: 50
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/first-deployment/deploy-a-package.md b/src/pages/docs/getting-started/first-deployment/deploy-a-package.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2025-01-7
-title: Deploy a sample package
-description: Step by step guide on how to deploy a sample package Octopus Deploy
+title: Deploy a package in Octopus Deploy
+description: Deploy a sample package using Octopus Deploy. Create a deploy package step, push an artifact to the built-in feed, and release it to your first environment.
 navOrder: 80
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/first-deployment/index.mdx b/src/pages/docs/getting-started/first-deployment/index.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-11-14
-title: First Deployment
-description: This tutorial will walk you through configuring your first deployment in Octopus Deploy.
+title: Your first deployment in Octopus Deploy
+description: Deploy your first application with Octopus. Set up environments, create a project, add a deployment target, and release your first software package today.
 navOrder: 10
 hideInThisSection: true
 ---

diff --git a/...pages/docs/getting-started/first-runbook-run/add-runbook-deployment-targets.mdx b/...pages/docs/getting-started/first-runbook-run/add-runbook-deployment-targets.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: Add runbook deployment targets
-description: Step by step guide on how to add deployment targets for runbooks in Octopus Deploy.
+title: Add deployment targets for Octopus runbooks
+description: Register a deployment target so your Octopus runbook can run scripts on your servers. Add the target, then update the runbook process steps to use it.
 navOrder: 70
 hideInThisSection: true
 ---

diff --git a/...pages/docs/getting-started/first-runbook-run/configure-runbook-environments.mdx b/...pages/docs/getting-started/first-runbook-run/configure-runbook-environments.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: Configure Runbook Environments
-description: Step by step guide on how to configure environments in Octopus Deploy.
+title: Configure environments for Octopus runbooks
+description: Set up environments in Octopus Deploy so your runbook has a place to run. Follow the step-by-step guide to create and configure your first environment.
 navOrder: 10
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/first-runbook-run/create-a-runbook.md b/src/pages/docs/getting-started/first-runbook-run/create-a-runbook.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: Create a runbook
-description: Step by step guide on how to create a runbook in Octopus Deploy.
+title: Create a runbook in Octopus Deploy
+description: Add a runbook to your Octopus Deploy project. Follow the step-by-step guide to create the runbook, name it, and prepare it for defining process steps.
 navOrder: 30
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/first-runbook-run/create-runbook-projects.mdx b/src/pages/docs/getting-started/first-runbook-run/create-runbook-projects.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: Create a Project
-description: Step by step guide on how to create projects in Octopus Deploy.
+title: Create a project for your Octopus runbook
+description: Create an Octopus Deploy project to hold your runbook. Follow the step-by-step guide to name the project, pick a lifecycle, and get ready to add a runbook.
 navOrder: 20
 hideInThisSection: true
 ---

diff --git a/...ocs/getting-started/first-runbook-run/define-the-runbook-process-for-targets.md b/...ocs/getting-started/first-runbook-run/define-the-runbook-process-for-targets.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: Defining the runbook process for targets
-description: Step by step guide on how to define a runbook process in Octopus Deploy.
+title: Define a runbook process for targets
+description: Define the steps in your Octopus Deploy runbook to run on deployment targets. Add a script step, target it by role, and save the runbook process to run.
 navOrder: 80
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/first-runbook-run/define-the-runbook-process.md b/src/pages/docs/getting-started/first-runbook-run/define-the-runbook-process.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: Defining the runbook process for workers
-description: Step by step guide on how to define a runbook process to run on Workers in Octopus Deploy.
+title: Define a runbook process for Workers
+description: Define the steps in your Octopus Deploy runbook to run on Workers. Add a script step, select a Worker pool, and save the runbook process to run on demand.
 navOrder: 40
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/first-runbook-run/index.mdx b/src/pages/docs/getting-started/first-runbook-run/index.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: First Runbook Run
-description: This section will walk you through how to configure your first runbook run in Octopus Deploy.
+title: Your first runbook run in Octopus Deploy
+description: Run your first Octopus Deploy runbook. Create a project, define the process steps, configure environments, add a target, and trigger your first runbook run.
 navOrder: 20
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/first-runbook-run/publishing-a-runbook.md b/src/pages/docs/getting-started/first-runbook-run/publishing-a-runbook.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: Publishing a runbook
-description: Step by step guide on how to publish an Octopus Deploy Runbook to use with triggers.
+title: Publish a runbook in Octopus Deploy
+description: Publish your Octopus Deploy runbook to make it available for scheduled triggers and deployment targets. Follow the step-by-step guide to create a snapshot.
 navOrder: 90
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/first-runbook-run/runbook-specific-variables.md b/src/pages/docs/getting-started/first-runbook-run/runbook-specific-variables.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: Runbook specific variables
-description: Step by step guide on how to define and use variables in an Octopus Deploy runbook.
+title: Variables in Octopus Deploy runbooks
+description: Add variables to your Octopus Deploy runbook to make scripts flexible. Define a variable, reference it in a step, and scope it to specific environments.
 navOrder: 60
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/first-runbook-run/running-a-runbook.md b/src/pages/docs/getting-started/first-runbook-run/running-a-runbook.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2026-04-16
-title: Running a Runbook
-description: Step by step guide on how to run a runbook in Octopus Deploy.
+title: Run a runbook in Octopus Deploy
+description: Trigger a runbook run in Octopus Deploy. Select the runbook, choose an environment, review the task summary, and verify the run completed successfully.
 navOrder: 50
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/getting-started/index.mdx b/src/pages/docs/getting-started/index.mdx
@@ -2,12 +2,12 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-05-24
-title: Getting started with Octopus
+title: Get started with Octopus Deploy
 subtitle: An overview of Octopus Deploy concepts
 icon: fa-solid fa-octopus
 navTitle: Overview
 navSection: Getting started
-description: This section provides an overview of Octopus Deploy concepts and links to the relevant documentation, which explore the concepts further and guide you through implementing them with Octopus Cloud or your own self-hosted Octopus Server
+description: Learn Octopus Deploy from scratch. Explore core concepts, complete your first deployment, run a runbook, and find best practices to help set up your team.
 navOrder: 5
 hideInThisSectionHeader: true
 ---

diff --git a/src/pages/docs/getting-started/managing-octopus-subscriptions.md b/src/pages/docs/getting-started/managing-octopus-subscriptions.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2025-06-13
-title: Managing Octopus subscriptions
-description: Control Center is where you manage your Octopus subscriptions and their associated user access. 
+title: Manage your Octopus subscriptions
+description: Use Octopus Control Center to manage your subscriptions, licenses, and user access. View billing details, add users, and adjust your plan from one place.
 navOrder: 40
 ---
 

diff --git a/src/pages/docs/getting-started/reference-architectures.md b/src/pages/docs/getting-started/reference-architectures.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-10-31
 modDate: 2023-11-13
-title: Reference architectures
-description: Populate an Octopus space with example projects and supporting resources demonstrating reference architectures
+title: Reference architectures for Octopus Deploy
+description: Populate an Octopus space with example projects showing reference architectures for common deployment patterns. Get a working setup running in minutes.
 navOrder: 55
 ---
 

diff --git a/...ages/docs/getting-started/reference-architectures/eks-reference-architecture.md b/...ages/docs/getting-started/reference-architectures/eks-reference-architecture.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-11-13
 modDate: 2023-11-13
-title: EKS reference architecture
-description: Populate an Octopus space with example projects deploying to an AWS EKS cluster
+title: EKS reference architecture for Octopus Deploy
+description: Populate an Octopus space with example projects that deploy to AWS EKS. Follow the guide to set up a Kubernetes deployment reference architecture in Octopus.
 navOrder: 1
 ---
 

diff --git a/...s/docs/getting-started/reference-architectures/webapp-reference-architecture.md b/...s/docs/getting-started/reference-architectures/webapp-reference-architecture.md
@@ -2,9 +2,9 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-11-13
 modDate: 2023-11-13
-title: Web App reference architecture in Octopus
+title: Azure Web App reference architecture
 navTitle: Web App reference architecture
-description: Populate an Octopus space with example projects deploying to an Azure web app
+description: Populate an Octopus space with example projects that deploy to an Azure web app. Follow the guide to set up a reference architecture for Azure deployments.
 navOrder: 2
 ---
 

diff --git a/src/pages/docs/getting-started/samples-instance.mdx b/src/pages/docs/getting-started/samples-instance.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2023-01-01
-title: Samples
-description: View real-world deployment and runbook examples in our Octopus Cloud samples instance - https://samples.octopus.app
+title: Octopus Deploy samples instance
+description: Explore real-world deployment and runbook examples in the Octopus samples instance. Browse projects to learn patterns and best practices you can apply today.
 navOrder: 50
 ---
 import SamplesAwsDeploymentFeatureList from 'src/shared-content/samples/samples-aws-deployment-feature-list.include.md';

diff --git a/src/pages/docs/installation/automating-installation.mdx b/src/pages/docs/installation/automating-installation.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2023-01-01
-title: Automating Octopus installation
-description: Information on how to install and configure an Octopus Server in a fully automated way from the command line.
+title: Automate Octopus Server installation
+description: Install and configure Octopus Server from the command line without manual steps. Use the Octopus Manager command-line interface for silent, repeatable installs.
 navOrder: 7
 ---
 import ServerDownloads from 'src/shared-content/installation/server-downloads.include.md';

diff --git a/src/pages/docs/installation/file-storage/aws-file-storage.mdx b/src/pages/docs/installation/file-storage/aws-file-storage.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-05-22
-title: AWS File Storage
-description: Guidelines and recommendations for configuring Octopus Deploy to use file storage options on AWS.
+title: AWS file storage for Octopus Deploy
+description: Store Octopus Deploy files on AWS using EFS or S3. Compare storage options and follow the configuration steps to mount and connect your chosen AWS service.
 navOrder: 20
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/installation/file-storage/azure-file-storage.mdx b/src/pages/docs/installation/file-storage/azure-file-storage.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-05-22
-title: Azure Files
-description: Guidelines and recommendations for configuring Octopus Deploy to use Azure Files.
+title: Azure Files for Octopus Deploy file storage
+description: Store Octopus Deploy files on Azure Files using SMB mounts. Review sizing recommendations and follow the configuration steps for Linux and Windows hosts.
 navOrder: 30
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/installation/file-storage/gcp-file-storage.mdx b/src/pages/docs/installation/file-storage/gcp-file-storage.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-05-22
-title: GCP File Storage
-description: Guidelines and recommendations for configuring Octopus Deploy to store files on GCP File Storage.
+title: GCP file storage for Octopus Deploy
+description: Store Octopus Deploy files on Google Cloud using Filestore with NFS v3 mounts. Follow the setup steps for both Linux and Windows Server hosts to get connected.
 navOrder: 40
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/installation/file-storage/index.md b/src/pages/docs/installation/file-storage/index.md
@@ -2,11 +2,11 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-05-22
-title: File Storage
+title: File storage for Octopus Deploy
 navTitle: Overview
 navSection: File Storage
 navOrder: 3
-description: How to configure file storage for Octopus Deploy
+description: Choose how Octopus Deploy stores its files. Options include local storage, AWS, Azure, and GCP. Pick the right setup for your environment and follow the guide.
 hideInThisSection: true
 ---
 

diff --git a/src/pages/docs/installation/file-storage/local-storage.mdx b/src/pages/docs/installation/file-storage/local-storage.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-05-22
-title: Local File Storage
-description: Guidelines and recommendations for configuring local file storage with Octopus Deploy.
+title: Local file storage for Octopus Deploy
+description: Store Octopus Deploy files on local disk or a network share. Review default folder locations, required permissions, and how to change the storage path.
 navOrder: 10
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/installation/file-storage/windows-nfs.md b/src/pages/docs/installation/file-storage/windows-nfs.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-07-30
-title: Windows NFS File Storage
-description: Guidelines and recommendations for configuring NFS File Storage with Octopus Deploy.
+title: Windows NFS file storage for Octopus Deploy
+description: Configure a Windows NFS share for Octopus Deploy file storage across nodes. Review prerequisites, share setup steps, and how to connect your Octopus instance.
 navOrder: 80
 hideInThisSection: true
 ---

diff --git a/src/pages/docs/installation/index.mdx b/src/pages/docs/installation/index.mdx
@@ -2,13 +2,13 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2024-05-01
-title: Installation of Octopus Server
+title: Install Octopus Server
 subtitle: How to install Octopus Server
 icon: fa-solid fa-server
 navTitle: Overview
 navSection: Installation
 navOrder: 20
-description: How to install the Octopus Server.
+description: Install Octopus Server on Windows or as a Linux container. Connect a SQL Server database, configure your instance, and start deploying software today.
 hideInThisSection: true
 ---
 import OctopusReleases from 'src/shared-content/installation/octopus-releases.include.md';

diff --git a/src/pages/docs/installation/isolated-octopus-deploy-servers.md b/src/pages/docs/installation/isolated-octopus-deploy-servers.md
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2023-01-01
-title: Isolated Octopus Servers
-description: Working with isolated Octopus Servers due to infrastructure or governance requirements.
+title: Isolated Octopus Deploy servers
+description: Run Octopus Deploy in an isolated network without internet access. Learn how to manage packages, upgrades, and Tentacle comms in air-gapped environments.
 navOrder: 11
 ---
 

diff --git a/src/pages/docs/installation/load-balancers/aws-load-balancers.mdx b/src/pages/docs/installation/load-balancers/aws-load-balancers.mdx
@@ -2,8 +2,8 @@
 layout: src/layouts/Default.astro
 pubDate: 2023-01-01
 modDate: 2026-02-23
-title: AWS Load Balancers
-description: Guidelines and recommendations for configuring Octopus Deploy to use load balancer options on AWS.
+title: AWS load balancers for Octopus Deploy
+description: Route traffic to Octopus Deploy using AWS load balancers. Review options including ALB and NLB, then follow the configuration guide for your own setup.
 navOrder: 20
 hideInThisSection: true
 ---