Skip to content

Commit 6d42351

Browse files
bgolatclaude
andauthored
Improve SEO: add meta descriptions, robots.txt, and site metadata (#340)
## Summary - Add missing meta descriptions to the landing page and 5 guide pages that had none - Remove redundant "Nebula Docs:" prefix from 3 guide descriptions to maximize SERP snippet space - Add `robots.txt` with sitemap reference - Enrich thin category index descriptions (config, guides, security) - Update `docusaurus.config.ts`: better tagline, site-wide keywords meta tag, navbar title for crawlability (visually hidden) - Add frontmatter blocks to 2 guide pages that had no frontmatter at all --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
1 parent e561326 commit 6d42351

15 files changed

Lines changed: 41 additions & 9 deletions

File tree

docs/config/_category_.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"position": 4,
44
"link": {
55
"type": "generated-index",
6-
"description": "Configuration options for Nebula.",
6+
"description": "Complete reference for all Nebula configuration options including PKI, firewall rules, lighthouse, relay, tun, and more.",
77
"slug": "/config"
88
}
99
}

docs/guides/_category_.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"position": 2,
44
"link": {
55
"type": "generated-index",
6-
"description": "A collection of how-to guides that explain how to use various capabilities of the Nebula overlay networking tool.",
6+
"description": "Step-by-step guides for configuring and troubleshooting Nebula overlay networks, including quick start, certificate management, DNS, and routing.",
77
"slug": "/guides"
88
}
99
}

docs/guides/debug-ssh-commands/index.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
---
22
title: Debugging with Nebula SSH commands
3+
description:
4+
Learn how to use Nebula's built-in SSH server commands to debug network connectivity issues on overlay hosts.
35
summary:
46
This guide describes useful commands built into the SSH server accessible over nebula, which can allow debugging
57
network connectivity for the nebula host.

docs/guides/quick-start/index.mdx

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
22
title: Quick Start
3-
description:
4-
'Nebula Docs: How to create your first overlay network using a Certificate Authority, Lighthouse, and Hosts'
3+
description: How to create your first overlay network using a Certificate Authority, Lighthouse, and Hosts
54
summary:
65
This section will walk you through setting up a simple nebula network for testing. The examples will need to be
76
modified to suit your particular environment.

docs/guides/rotating-certificate-authority/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Rotating a Certificate Authority
3-
description: 'Nebula Docs: How to rotate an expiring certificate authority without downtime.'
3+
description: How to rotate an expiring Nebula certificate authority without downtime.
44
summary:
55
This guide will teach you how to migrate from an expiring certificate authority by creating a new certificate
66
authority, updating your device's Nebula config to trust the new authority, signing new host certificates, and

docs/guides/sign-certificates-with-public-keys/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Signing a Certificate Without a Private Key
3-
description: 'Nebula Docs: How to sign certificates without copying private keys across devices.'
3+
description: How to sign Nebula certificates without copying private keys across devices.
44
summary:
55
After reading this guide you will be able to create public/private keypairs on devices you wish to add to the Nebula
66
network and generate certificates for them using only the public key.

docs/guides/unsafe_routes/index.mdx

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
---
22
title: Extend network access beyond overlay hosts
3+
description:
4+
Configure Nebula unsafe_routes to route traffic through overlay hosts and reach devices that cannot run Nebula
5+
directly.
36
summary:
47
This guide explains how to configure Nebula to route traffic destined for a specific subnet through a specific overlay
58
network host, which is useful for accessing hosts that cannot be modified to run Nebula.

docs/guides/upgrade-to-cert-v2-and-ipv6/index.mdx

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
---
22
title: Upgrading a Nebula network to IPv6 overlay addresses
3+
description:
4+
Step-by-step guide to upgrading an existing Nebula network to the v2 certificate format and enabling IPv6 overlay
5+
addresses.
36
summary:
47
This guide describes how to upgrade an existing nebula network to the v2 certificate format and enable IPv6 addresses.
58
---

docs/guides/using-lighthouse-dns/index.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
title: Using Lighthouse DNS with Nebula
3+
description:
4+
Configure Nebula's experimental built-in DNS server on Lighthouse hosts to resolve overlay network hostnames.
5+
---
6+
17
# Using Experimental Lighthouse DNS with Nebula
28

39
:::warning

docs/guides/viewing-nebula-logs/index.mdx

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,8 @@
1+
---
2+
title: Viewing Nebula Logs
3+
description: How to view Nebula logs on Linux, macOS, Windows, iOS, and Android for troubleshooting and monitoring.
4+
---
5+
16
import ThemedImage from '@theme/ThemedImage';
27

38
# Viewing Nebula Logs

0 commit comments

Comments
 (0)