Skip to content

Profiles page: rendered examples and per-edition canonical URLs - #7872

Open
devin-ai-integration[bot] wants to merge 5 commits into
mainfrom
devin/1794622361-profiles-examples
Open

devin-ai-integration[bot] wants to merge 5 commits into
mainfrom
devin/1794622361-profiles-examples

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Profiles let one docs page publish as several editions: a page writes ${NAME} placeholders, and each product, version, or tab fills them from its own profile in docs.yml (for example, a shared install page that reads "Acme" under Community and "Acme Enterprise" under Enterprise). This PR adds a See it in action walkthrough with rendered screenshots to the Profiles page. It also documents that each edition now gets its own canonical URL and sitemap entry, so search engines can index every edition of a profiled page instead of treating them all as one canonical page.

Implements docs for: fix(docs): give each profile edition of a page its own canonical URL (fern-api/fern-platform#16178), fix(cli): bump fdr-sdk for profile-aware canonical URLs (fern-api/fern#18865). Profiles feature: fern-api/fern#18816.

  • See it in action (new ## section, before "Define profiles"): a three-step <Steps> walkthrough.
    1. The profiles block in docs.yml, with Community on the site profile and Enterprise on its own.
    2. A shared pages/install.mdx plus the product nav file, both using ${PRODUCT} and ${CLI}.
    3. Community and Enterprise <Tabs> with light and dark screenshots of the rendered page.
  • Screenshots: taken from a real site built with fern docs dev (CLI 5.216.0) using the config shown in steps 1 and 2. That site sets Lato as its body and heading font, and the screenshots are captured at a 1024px viewport so the text is legible in the embed.
  • "Use placeholders" keeps its original short example. It now also says that each edition gets its own canonical URL and sitemap entry, and that copies with identical (or no) values share one canonical URL.
  • SEO overview: the sitemap paragraph gets a one-line pointer to Profiles.

Enterprise tab on the preview:

Enterprise tab, light
Enterprise tab, dark

Link to Devin session: https://app.devin.ai/sessions/f146b30e968048ddbeb980344d9bdcf4
Open in Devin Desktop: https://app.devin.ai/desktop/session/f146b30e968048ddbeb980344d9bdcf4?variant=devin


🟢 Devin Review found nothing to fix · View findings

Devin Review

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Devin Review

@github-actions

github-actions Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

🌿 Preview your docs: https://fern-preview-devin-1794622361-profiles-examples.docs.buildwithfern.com/learn

Here are the markdown pages you've updated:

kgowru and others added 4 commits November 14, 2026 03:49
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration devin-ai-integration Bot changed the title Add rendered examples to the Profiles page Profiles page: rendered examples and per-edition canonical URLs Nov 15, 2026
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