Skip to content

fix(seo): fix page titles, meta descriptions, OG tags, and heading st…#1155

Merged
LiamRandall merged 79 commits into
mainfrom
seo-fix-meta-and-structure
May 19, 2026
Merged

fix(seo): fix page titles, meta descriptions, OG tags, and heading st…#1155
LiamRandall merged 79 commits into
mainfrom
seo-fix-meta-and-structure

Conversation

@LiamRandall
Copy link
Copy Markdown
Member

…ructure

  • Normalized all page titles to 30-60 characters with target keywords
  • Added/fixed meta descriptions (120-160 chars) on all pages
  • Added complete Open Graph and Twitter Card meta tags
  • Fixed H1 tags: one per page, keyword-aligned
  • Corrected heading hierarchy (no skipped levels)
  • Added canonical URLs where missing

@netlify
Copy link
Copy Markdown

netlify Bot commented May 16, 2026

Deploy Preview for dreamy-golick-5f201e ready!

Name Link
🔨 Latest commit fba7953
🔍 Latest deploy log https://app.netlify.com/projects/dreamy-golick-5f201e/deploys/6a0baaaca8b440000842dcc3
😎 Deploy Preview https://deploy-preview-1155--dreamy-golick-5f201e.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Member Author

@LiamRandall LiamRandall left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a lot here, almost all cosmetic. While we are adding descriptions to older legacy pages we dont' care as much about (old blogs) they are deprioritized in the sitemap.xml. So let's just accept for now.

@LiamRandall LiamRandall force-pushed the seo-fix-meta-and-structure branch from 29bba4b to e61b511 Compare May 16, 2026 19:13
@LiamRandall LiamRandall marked this pull request as ready for review May 16, 2026 19:26
@LiamRandall LiamRandall requested a review from a team as a code owner May 16, 2026 19:26
ericgregory and others added 3 commits May 16, 2026 18:05
Resolve "iPhone" auto-transcription artifact to Pavel (GitHub: if0ne) in
two summaries and two transcripts, and remove an expletive from the
2026-04-22 transcript.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Liam Randall <liam@cosmonic.com>
…ructure

- Normalized all page titles to 30-60 characters with target keywords
- Added/fixed meta descriptions (120-160 chars) on all pages
- Added complete Open Graph and Twitter Card meta tags
- Fixed H1 tags: one per page, keyword-aligned
- Corrected heading hierarchy (no skipped levels)
- Added canonical URLs where missing

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Liam Randall <liam@cosmonic.com>
…optimize priority pages

- Added themeConfig.metadata: og:type=website (was missing on non-blog pages)
  and twitter:site=@wasmCloud (now emitted site-wide)
- Tightened 37 over-160-char community meeting descriptions to 130-155 chars
- Homepage description now targets 'platform engineering' and 'IDPs'
  (per keyword strategy: quick-win KD 30, no page targeted before)
- docs/overview/workloads/components.mdx title now leads with
  'Wasm Component Model' (existing #16 rank, quick-win optimization)
- docs/kubernetes-operator/index.mdx title now leads with
  'WebAssembly on Kubernetes' (existing #10 rank, quick-win optimization)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Liam Randall <liam@cosmonic.com>
@LiamRandall LiamRandall force-pushed the seo-fix-meta-and-structure branch from 0f50e6f to d166629 Compare May 16, 2026 22:05
Updated the description in the ContactForm component to include additional features.

Signed-off-by: Liam Randall <liam.randall@gmail.com>
Comment thread docs/contributing/contributing-guide.mdx
Comment thread docs/contributing/documentation.mdx
Comment thread docs/kubernetes-operator/api-reference.md
Comment thread docs/kubernetes-operator/operator-manual/cicd.mdx
Comment thread docs/wash/developer-guide/language-support/typescript/messaging.mdx
Comment thread docs/wash/developer-guide/useful-webassembly-tools.mdx
Comment thread docs/wash/faq.mdx
Comment thread docs/wash/registries.mdx
Comment thread docs/kubernetes-operator/api-reference.md
Comment thread docs/kubernetes-operator/workload-security.mdx
Comment thread docs/overview/hosts/plugins.mdx
Comment thread docs/recipes/plugin-or-service.mdx
Comment thread docs/runtime/washlet.mdx
Comment thread docs/wash/commands.mdx
Comment thread docs/wash/config.mdx
Comment thread docs/wash/faq.mdx
Eight pages have SEO-stuffed titles that read awkwardly as page headers
(e.g., "Interfaces — WASI and Wasm Component Model"). Adds
`hide_title: true` plus a `sidebar_label` and a short manual H1 so the
SEO `<title>` is preserved while the rendered page heading and sidebar
label stay readable.

These are the eight overview/contributing/operator pages whose diff
hunks didn't reach far enough for a GitHub suggestion to anchor the H1
insertion.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Comment thread docs/migration.mdx
Comment thread docs/migration.mdx Outdated
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
…es.mdx

Signed-off-by: Eric Gregory <eric@cosmonic.com>
…e-storage.mdx

Signed-off-by: Eric Gregory <eric@cosmonic.com>
…g.mdx

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
…ts.mdx

Signed-off-by: Eric Gregory <eric@cosmonic.com>
…tion.mdx

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added description and sidebar label to wasmCloud documentation.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Stacked suggestion acceptance left fourteen files with two identical
sidebar_label entries straddling hide_title, which broke YAML parsing
and the Docusaurus build. Drops the redundant entries.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
A hide_title suggestion replaced lines 2-7 of the file but only
preserved one of the two MDX component imports, breaking SSR with
"Expected component `Tabs` to be defined". Restores the import.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added metadata and introductory content to glossary.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added metadata for FAQ page including title, sidebar label, and description.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added a description and improved the structure of the troubleshooting document for clarity.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added sidebar label and updated title visibility.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added a description for the recipes guide.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added a new section header for the quickstart tutorial.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added introductory section about wasmCloud host as a runtime environment for WebAssembly workloads.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added a section explaining workloads and their components.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Added a description to the contributing guide for clarity.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
Signed-off-by: Eric Gregory <eric@cosmonic.com>
@LiamRandall
Copy link
Copy Markdown
Member Author

Let's go!

@LiamRandall LiamRandall merged commit 7927739 into main May 19, 2026
7 checks passed
@LiamRandall LiamRandall deleted the seo-fix-meta-and-structure branch May 19, 2026 00:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants