Skip to content

Conversation

@devin-ai-integration
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Nov 4, 2025

Document what Fern automatically generates for SEO metadata

Summary

Added a new section "What Fern automatically generates" to the SEO metadata documentation page that explicitly lists all the SEO metadata tags Fern auto-generates for every documentation page. This addresses user confusion about what's automatically handled versus what needs manual configuration.

The new section covers:

  • HTML meta tags (title, description, keywords, canonical URL, robots, favicon)
  • Open Graph tags for social media previews
  • Twitter Card tags
  • The three-tier fallback system (page-level → site-level → sensible defaults)

Technical details were derived from code review of generateMetadataFromPage() and generateMetadataFromConfig() in fern-platform/packages/fern-docs/bundle/src/components/seo.ts.

Review & Testing Checklist for Human

  • Verify technical accuracy: Open the preview deployment, view page source on any documentation page, and confirm the listed metadata tags are actually present in the <head> section
  • Check rendering: Verify the page renders correctly on the preview site - confirm formatting, spacing, and bullet points display properly
  • Validate style compliance: The new section uses extensive bullet points for listing metadata tags. Confirm this is acceptable for reference-style content, given the style guideline to "avoid excessive bullet points"
  • Verify completeness: Cross-reference with the source code or generated HTML to ensure no metadata tags are missing from the documentation

Test plan: Navigate to the preview deployment, open browser DevTools on any docs page, inspect the <head> section, and verify that the metadata tags listed in the new section are actually present in the HTML output.

Notes

Co-Authored-By: Chris McDonnell <chris@buildwithfern.com>
@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

The metadata configurations on this page are for SEO and social tags that aren't visible to users. For visible footer links, see [footer links configuration](/learn/docs/configuration/what-is-docs-yml#footer-links-configuration).
</Note>

## What Fern auto-generates
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Microsoft.Auto] In general, don't hyphenate 'auto-generates'.

@github-actions
Copy link
Contributor

github-actions bot commented Nov 4, 2025

Co-Authored-By: Chris McDonnell <chris@buildwithfern.com>
@github-actions
Copy link
Contributor

github-actions bot commented Nov 4, 2025

@github-actions
Copy link
Contributor

github-actions bot commented Nov 4, 2025

@devalog devalog merged commit f3e79ac into main Nov 4, 2025
2 checks passed
@devalog devalog deleted the devin/1762276802-document-seo-autogeneration branch November 4, 2025 18:18
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.

3 participants