dac, access profiles, tool groups docs#3738
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Caution Review failedThe pull request is closed. ℹ️ Recent review info⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: ⛔ Files ignored due to path filters (12)
📒 Files selected for processing (28)
📝 WalkthroughSummary by CodeRabbit
WalkthroughThis PR substantially expands Bifrost Enterprise documentation by introducing three core governance feature pages (Access Profiles, MCP Tool Groups, Data Access Control), adding comprehensive migration guides from OSS to Enterprise, defining OpenAPI contracts for all new governance APIs, reorganizing enterprise marketing messaging with numbered feature sections, and marking WASM plugins as deprecated in favor of Go plugins. Navigation is consolidated in docs.json with new redirects for deprecated pages. ChangesEnterprise Documentation Restructuring and API Contracts
🎯 4 (Complex) | ⏱️ ~60 minutes Possibly Related PRs
Suggested Reviewers
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
|
|
44c7956 to
3d02f30
Compare
3d02f30 to
d07947d
Compare
d07947d to
737bca5
Compare
Merge activity
|
Confidence Score: 4/5Safe to merge; all changes are documentation and OpenAPI spec additions with no runtime code affected. The two stale alt-text strings and the 200/201 status-code inconsistency on createRole are the only issues; neither prevents the docs from rendering correctly, but the status-code mismatch could trip up SDK generators. docs/openapi/paths/management/rbac.yaml (createRole response code) and docs/enterprise/access-profiles.mdx (two incorrect alt-text strings). Important Files Changed
Reviews (1): Last reviewed commit: "dac, access profiles, tool groups docs" | Re-trigger Greptile |
| <img | ||
| src="/media/access-profiles/new-access-profile.png" | ||
| alt="Access Profiles list page with table columns and create button" | ||
| /> |
There was a problem hiding this comment.
The alt text for the "new access profile" form image was copied from the list-page image and no longer describes what the screenshot actually shows. This hurts screen-reader accessibility and image SEO.
| <img | |
| src="/media/access-profiles/new-access-profile.png" | |
| alt="Access Profiles list page with table columns and create button" | |
| /> | |
| <img | |
| src="/media/access-profiles/new-access-profile.png" | |
| alt="New Access Profile creation form showing name and description fields" | |
| /> |
| <img | ||
| src="/media/access-profiles/access-profile-provider-config.png" | ||
| alt="Access Profiles list page with table columns and create button" | ||
| /> |
There was a problem hiding this comment.
Same stale alt text issue: this image shows the provider configuration accordion, not the list page.
| <img | |
| src="/media/access-profiles/access-profile-provider-config.png" | |
| alt="Access Profiles list page with table columns and create button" | |
| /> | |
| <img | |
| src="/media/access-profiles/access-profile-provider-config.png" | |
| alt="Access Profile provider configuration showing allowed models, budget, and rate limit settings" | |
| /> |
| responses: | ||
| '200': | ||
| description: Role created | ||
| content: | ||
| application/json: | ||
| schema: | ||
| $ref: '../../schemas/management/rbac.yaml#/RoleResponse' | ||
| '400': | ||
| $ref: '../../openapi.yaml#/components/responses/BadRequest' | ||
| '500': | ||
| $ref: '../../openapi.yaml#/components/responses/InternalError' | ||
|
|
||
| roles-by-id: |
There was a problem hiding this comment.
The
createRole POST responds with 200 while both createAccessProfile and createMCPToolGroup — added in the same PR — respond with 201. REST convention reserves 201 Created for successful resource creation; using 200 here is inconsistent and may confuse SDK generators or clients that check for 201 after a POST.
| responses: | |
| '200': | |
| description: Role created | |
| content: | |
| application/json: | |
| schema: | |
| $ref: '../../schemas/management/rbac.yaml#/RoleResponse' | |
| '400': | |
| $ref: '../../openapi.yaml#/components/responses/BadRequest' | |
| '500': | |
| $ref: '../../openapi.yaml#/components/responses/InternalError' | |
| roles-by-id: | |
| responses: | |
| '201': | |
| description: Role created | |
| content: | |
| application/json: | |
| schema: | |
| $ref: '../../schemas/management/rbac.yaml#/RoleResponse' | |
| '400': | |
| $ref: '../../openapi.yaml#/components/responses/BadRequest' | |
| '500': | |
| $ref: '../../openapi.yaml#/components/responses/InternalError' | |
| roles-by-id: |

Summary
Briefly explain the purpose of this PR and the problem it solves.
Changes
Type of change
Affected areas
How to test
Describe the steps to validate this change. Include commands and expected outcomes.
If adding new configs or environment variables, document them here.
Screenshots/Recordings
If UI changes, add before/after screenshots or short clips.
Breaking changes
If yes, describe impact and migration instructions.
Related issues
Link related issues and discussions. Example: Closes #123
Security considerations
Note any security implications (auth, secrets, PII, sandboxing, etc.).
Checklist
docs/contributing/README.mdand followed the guidelines