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): add title frontmatter and fix heading hierarchy on homepage#26

Open
ekline[bot] wants to merge 1 commit into
main from
docs/seo/add-homepage-title-fix-heading
Open

docs(seo): add title frontmatter and fix heading hierarchy on homepage #26
ekline[bot] wants to merge 1 commit into
main from
docs/seo/add-homepage-title-fix-heading

Conversation

@ekline

@ekline ekline Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

Summary

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

SEO keyword map

Extracted from fastn.ai marketing site:

  • Primary keywords: embedded integration platform, AI agent integrations, adaptive context layer, tool orchestration, MCP server
  • Secondary keywords: embedded integrations for SaaS, AI workflow automation, managed OAuth, multi-tenant integrations, unified context layer, integration hub
  • Audience terms: SaaS companies, AI agent builders, developers, engineering teams

Top 3 findings

Rank Priority Scope Issue Proposed fix
1 High All 34 pages Missing title frontmatter on every page. The HTML title tag is unset, so GitBook falls back to H1, which is often generic. Add title frontmatter to each page, starting with the homepage.
2 High 24 of 34 pages Heading hierarchy violations. H1 jumps to H3 (skipping H2) on 70% of pages. Promote H3 sections to H2 where appropriate.
3 Medium Component pages Page titles lack product keywords. H1s like Trigger, Loop, Switch contain no Fastn context. Adjust titles to include Fastn context.

What this PR fixes

Addresses finding #1 on the highest-impact page, the documentation homepage (README.md):

  • Adds title frontmatter so the HTML title tag includes the primary keyword embedded integration platform (53 chars, within 30-60 char SEO range).
  • Fixes heading hierarchy by promoting H3 to H2 for the connectors section, restoring proper H1 to H2 flow.
  • Applies style improvements caught during pre-commit review: removes banned phrases, fixes hyphenation, converts passive voice to active, corrects number formatting, and adds a missing period.

Remaining items (follow-up work)

How to verify

  1. Check that the title field renders correctly in the GitBook preview.
  2. Verify the heading hierarchy flows H1 to H2 without skipping levels.
  3. Confirm no content was removed.

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

 

Add missing title frontmatter field to docs/README.md for proper HTML
<title> tag rendering. Fix heading hierarchy by promoting H3 to H2 for
the connectors section. Apply style improvements: remove banned phrases,
fix hyphenation, convert passive voice, and correct number formatting.
ekline[bot] <202747777+ekline[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

0 participants

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