Skip to content

Move FAQs into /docs/faqs#5075

Open
bgrenon wants to merge 3 commits into
mainfrom
docs/faqs-to-docset
Open

Move FAQs into /docs/faqs#5075
bgrenon wants to merge 3 commits into
mainfrom
docs/faqs-to-docset

Conversation

@bgrenon

@bgrenon bgrenon commented Jun 15, 2026

Copy link
Copy Markdown
Collaborator

Ask AI trusts content under /docs/* and treats everything else as untrusted. FAQs lived at /faqs, outside the trust boundary and excluded from llms.txt. This moves the entire FAQ corpus into /docs/faqs so it's trusted and agent-discoverable.

preview:
https://neon-next-git-docs-faqs-to-docset-neondatabase.vercel.app/docs/faqs

Commit 1

Commit 1: docs: forklift FAQs… (content, ~130 files)

Mechanical move of all 129 FAQ pages from content/faqs/ to content/docs/faqs/, frontmatter mapped to docs shape, and a redirectFrom on each. Mostly renames, so skim.

Commit 2

Commit 2: feat: add FAQ hub… (16 files)

These are component/website changes to support the move:

Reuses the existing FaqSearch / FaqCard components to render /docs/faqs as a searchable index via a special case in the docs [...slug] route.

Gives FAQ pages a distinct zone with a top-level FAQs header item and icon, a full-width title with the copy-page button, an empty bordered sidebar, and a FAQs breadcrumb.

Adds the /faqs/docs/faqs redirects and repoints the footer link.

Result

  • 129 FAQs now live at /docs/faqs/*, trusted and included in llms.txt; searchable hub at /docs/faqs.
  • Old /faqs URLs 308 to the new ones; footer "FAQs" link repointed.

This pull request and its description were written by Isaac.

bgrenon added 2 commits June 15, 2026 13:20
Move all 129 FAQ pages from content/faqs to content/docs/faqs so they live
under /docs/* (trusted by Ask AI, included in llms.txt). Frontmatter mapped to
docs shape; each page carries a redirectFrom for its old /faqs URL.

Co-authored-by: Isaac
Render /docs/faqs as a searchable index (reusing FaqSearch/FaqCard), add the
top-level FAQs header entry and icon, a self-contained FAQ zone (empty sidebar,
FAQs breadcrumb), copy-page placement, and /faqs -> /docs/faqs redirects.

Co-authored-by: Isaac
@bgrenon bgrenon requested a review from danieltprice as a code owner June 15, 2026 17:17
@vercel

vercel Bot commented Jun 15, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
neon-next Ready Ready Preview, Comment Jun 15, 2026 5:29pm

Request Review

# Conflicts:
#	content/docs/faqs/change-region-existing-neon-project.md
#	content/docs/faqs/check-neon-project-region.md
#	content/docs/faqs/check-postgresql-version-neon.md
#	content/docs/faqs/create-new-database-neon-project.md
#	content/docs/faqs/create-new-neon-project.md
#	content/docs/faqs/delete-database-neon.md
#	content/docs/faqs/failed-to-fetch-error-tables-view.md
#	content/docs/faqs/rotate-database-credentials-after-breach.md
#	content/docs/faqs/rotate-database-password-after-leak.md
#	content/docs/faqs/rotate-database-url-connection-string.md
#	content/docs/faqs/rotate-neon-api-keys.md
#	content/docs/faqs/where-find-database-connection-string.md
#	next.config.js
@philip

philip commented Jun 22, 2026

Copy link
Copy Markdown
Collaborator

@bgrenon close (not merge) this PR?

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.

2 participants