Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

docs(seo): Expand flow component page titles for search visibility#23

Open
ekline[bot] wants to merge 1 commit into
main from
docs/seo/expand-flow-component-titles
Open

docs(seo): Expand flow component page titles for search visibility #23
ekline[bot] wants to merge 1 commit into
main from
docs/seo/expand-flow-component-titles

Conversation

@ekline

@ekline ekline Bot commented Apr 16, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Expanded 17 single-word H1 page titles (e.g., "Loop", "Filter", "Switch") on flow component pages to include keyword context (e.g., "Repeat actions with Loop in Fastn flows")
  • Updated SUMMARY.md navigation labels to match the new H1 titles
  • All titles now include "Fastn flows" for brand keyword alignment

Context

This PR addresses the #1 SEO issue identified by auditing the documentation against fastn.ai's keyword strategy. Single-word titles like "Loop" (4 chars) and "Limit" (5 chars) give search engines no context about what the page covers, making it nearly impossible to rank for relevant queries.

Keyword map (from fastn.ai marketing site)

Primary keywords: embedded integration platform, AI agent integrations, unified context layer, MCP server, integration hub
Secondary keywords: multi-tenant MCP server, dynamic tool filtering, workflow orchestration, prebuilt connectors
Audience: SaaS companies, AI agent builders, developers

Top 3 SEO findings

Rank Priority Issue Status
1 High 17 flow component pages have single-word H1 titles (4-13 chars) with no keyword context Fixed in this PR
2 High 3 files have heading hierarchy violations (H1 → H3 skipping H2) Follow-up
3 Medium 12 files have meta descriptions under 120 characters Follow-up

Files changed (18)

  • SUMMARY.md — Updated navigation labels
  • 12 flow component pages under flows/flow-setup-essentials/designing-a-flow/
  • 5 flow transformation pages under flows/flow-setup-essentials/designing-a-flow/flow-transformation/

How to verify

  1. Check the updated H1 headings render correctly in GitBook preview
  2. Verify SUMMARY.md sidebar labels match the new H1 titles
  3. Confirm no broken links were introduced

Test plan

  • GitBook preview renders updated titles correctly in sidebar navigation
  • Page titles appear in browser tab as expected
  • No broken internal links from title changes

ekline[bot] <202747777+ekline[bot]@users.noreply.github.com>

Single-word titles like Loop, Filter, and Switch lack the keyword
context search engines need to rank and display pages effectively.
Updated 17 flow component H1 headings to include Fastn flows keyword
context, and updated SUMMARY.md navigation labels to match.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@usmanaslam712 usmanaslam712 Awaiting requested review from usmanaslam712

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

AltStyle によって変換されたページ (->オリジナル) /