Skip to content

Conversation

bulgarian-beast
Copy link

Fixes a broken link in the Machine Identities documentation.

  • The "Role Assignment" link in docs/documentation/platform/identities/machine-identities.mdx
    was pointing to /documentation/platform/role-based-access-controls which returned a 404.
  • Updated it to /documentation/platform/access-controls/role-based-access-controls, which is the correct path already used elsewhere in the same file.
  • This ensures that the documentation is consistent and that the link resolves properly.

Fixes #4597

Type

  • Bug fix
  • New feature
  • Improvement
  • Breaking change
  • Documentation

Tests

I tested this change locally using Mintlify:

cd docs
mintlify dev

Steps performed

  1. Opened the local docs at: http://localhost:3001/documentation/platform/identities/machine-identities
  2. Navigated to Key Features → Role Assignment.
  3. Verified that the link now points to: http://localhost:3001//documentation/platform/access-controls/role-based-access-controls and opens without a 404.

Screenshot

Screenshot 2025-10-02 at 10 12 36

Additional checks

  • Confirmed the updated link resolves correctly without errors.
  • Verified that the docs build successfully with no regressions.

@maidul98
Copy link
Collaborator

maidul98 commented Oct 2, 2025

🎉 Snyk checks have passed. No issues have been found so far.

security/snyk check is complete. No issues have been found. (View Details)

Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

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

Greptile Overview

Summary

This PR fixes a broken documentation link in the Machine Identities page. The "Role Assignment" link was incorrectly pointing to `/documentation/platform/role-based-access-controls` which returns a 404 error, and has been updated to the correct path `/documentation/platform/access-controls/role-based-access-controls`. This change ensures consistency within the documentation as the correct path was already being used elsewhere in the same file.

The fix is part of maintaining the documentation quality for Infisical's role-based access control (RBAC) system, which is a core component of the platform's permissions architecture. Based on the context provided, the permissions system is structured around a subject-action-object model with both project and organization level permissions, making proper documentation links critical for user navigation.

Changed Files
Filename Score Overview
docs/documentation/platform/identities/machine-identities.mdx 5/5 Fixed broken Role Assignment link from incorrect 404 path to correct role-based access controls documentation path

Confidence score: 5/5

  • This PR is extremely safe to merge with no risk of production issues
  • Score reflects a simple documentation link fix with thorough local testing and validation
  • No files require special attention as this is a straightforward documentation correction

1 file reviewed, no comments

Edit Code Review Agent Settings | Greptile

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.

Docs: Broken Role Assignment link in Machine Identities page
2 participants