Skip to content

docs: improve SEO for flow design reference pages#19

Merged
usmanaslam712 merged 1 commit into
mainfrom
docs/seo-review-2026-04-09
Apr 16, 2026
Merged

docs: improve SEO for flow design reference pages#19
usmanaslam712 merged 1 commit into
mainfrom
docs/seo-review-2026-04-09

Conversation

@ekline

@ekline ekline Bot commented Apr 9, 2026

Copy link
Copy Markdown
Contributor

Context

This PR addresses SEO issues identified by auditing the Fastn documentation against the company's keyword strategy derived from fastn.ai.

Keyword map

Primary keywords: embedded integration platform, AI agent integrations, unified context layer, MCP gateway, connect AI agents to tools

Secondary keywords: workflow automation, managed OAuth, dynamic tool filtering, multi-tenant architecture, prebuilt connectors, AI workflow automation

Audience: SaaS companies, AI agent builders, platform engineers, developers building integrations


Top 3 SEO findings

Rank Priority Pages Issue Proposed fix
1 High 10 files in flows/flow-setup-essentials/designing-a-flow/ Missing meta descriptions — core product reference pages (connectors, loops, switches, variables, etc.) have no frontmatter, so search engines auto-generate poor snippets Add description frontmatter with keyword-aligned summaries (120–160 chars)
2 High ~13 tutorial files in flows/tutorials/ Missing meta descriptions on tutorials — high-value SEO content with no description metadata for search result snippets Add description frontmatter with action-oriented summaries
3 Medium UCL pages in ucl-unified-context-layer/ Keyword misalignment — pages covering MCP functionality don't mention "MCP server" or "Model Context Protocol" in descriptions Update descriptions to include MCP-related keywords

What this PR fixes

Finding #1: Added description frontmatter to all 10 flow design reference pages that were missing metadata entirely:

  • connectors.md — prebuilt connectors, 250+ apps
  • loop.md — loop components, workflow automation
  • switch.md — conditional branching, automation paths
  • variables.md — reusable values, flow configuration
  • data-mapper.md — data transformation between steps
  • database.md — SQL queries, structured data in flows
  • converter.md — format conversion (JSON, CSV, XML, Parquet)
  • custom-code.md — JavaScript, Python, C# custom logic
  • download-file.md — file fetching for automation steps
  • flow-response-success-and-error.md — HTTP response configuration

Each description is 120–160 characters, includes relevant keywords from the SEO strategy, and is action-oriented for better click-through rates in search results.

Remaining items

How to verify

  1. Check that each modified file has valid YAML frontmatter with a description field.
  2. Preview the pages in GitBook to confirm descriptions render correctly as meta tags.
  3. Verify no existing content was changed — only frontmatter was added.

Add frontmatter description fields to all pages in
flows/flow-setup-essentials/designing-a-flow/ that were missing them.
Descriptions are 120-160 characters, keyword-aligned with the
company's SEO strategy, and action-oriented for search snippets.
@usmanaslam712 usmanaslam712 merged commit 58ddc07 into main Apr 16, 2026
2 checks passed
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.

1 participant