Skip to content

Conversation

@devin-ai-integration
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Feb 12, 2026

Summary

Adds documentation clarifying that the fern, apis, and changelog folders are reserved names and must be named exactly as shown. Also clarifies that pages and assets are not reserved and can use any name. Changes span three pages:

  • Docs project-structure.mdx: New "Reserved folder names" section with a table and warning callout, placed after the top-level folders list. Also adds a sentence in the Multiple APIs accordion reinforcing that apis must use that exact name. Clarifies in the top-level folders list that pages and assets can use any name.
  • changelogs.mdx: Adds a sentence to the intro paragraph noting the changelog folder naming requirement.
  • API Definitions project-structure.mdx: Adds a sentence to the "Multiple APIs" section noting that the apis folder must use that exact name.

Review & testing checklist for human

  • Verify the claim that pages and assets can truly be named anything — this is stated as fact and could mislead users if incorrect
  • Verify the changelog link in the table (/learn/docs/configuration/changelogs) resolves correctly on the preview site
  • Check the API Definitions project structure page to confirm the apis sentence reads naturally in context
  • Consider whether the table's "Folder" and "Required name" columns are redundant — both show the same value. A simpler format (just folder + description) may be cleaner

Suggested test plan: Open each of the three preview pages linked below and read through the new/changed content to confirm accuracy and that it flows well with the surrounding text.

Notes

Requested by: Fern Support
Link to Devin run

@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

@github-actions
Copy link
Contributor

github-actions bot commented Feb 12, 2026

@devalog devalog merged commit fceb172 into main Feb 12, 2026
2 checks passed
@devalog devalog deleted the fern/special-named-folders branch February 12, 2026 17:01
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