Document respect-per-spec-base-path OpenAPI setting

[devin-ai-integration]

Summary

Documents the new opt-in respect-per-spec-base-path OpenAPI setting (fern-api/fern#17495). When a project merges multiple OpenAPI specs, this setting applies each spec's x-fern-base-path to its own endpoints instead of collapsing to a single API-wide base path.

• fern/snippets/openapi-specs.mdx — new settings.respect-per-spec-base-path <ParamField> (boolean, default false). Shared by the SDKs and API Definitions generators.yml references.
• fern/products/api-def/openapi/extensions/base-path.mdx — cross-reference to the new setting.

Checks: Vale clean, fern check --warnings 0 errors.

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

[devin-ai-integration]

🤖 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, CI, and merge conflict monitoring

[github-actions]

🌿 Preview your docs: https://fern-preview-devin-1787850377-respect-per-spec-base-path.docs.buildwithfern.com/learn

Here are the markdown pages you've updated:

• learn/api-definitions/openapi/extensions/base-path