docs: improve SEO for flow design reference pages#19
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
flows/flow-setup-essentials/designing-a-flow/descriptionfrontmatter with keyword-aligned summaries (120–160 chars)flows/tutorials/descriptionfrontmatter with action-oriented summariesucl-unified-context-layer/What this PR fixes
Finding #1: Added
descriptionfrontmatter to all 10 flow design reference pages that were missing metadata entirely:connectors.md— prebuilt connectors, 250+ appsloop.md— loop components, workflow automationswitch.md— conditional branching, automation pathsvariables.md— reusable values, flow configurationdata-mapper.md— data transformation between stepsdatabase.md— SQL queries, structured data in flowsconverter.md— format conversion (JSON, CSV, XML, Parquet)custom-code.md— JavaScript, Python, C# custom logicdownload-file.md— file fetching for automation stepsflow-response-success-and-error.md— HTTP response configurationEach 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
flows/tutorials/How to verify
descriptionfield.