more title fixes

Signed-off-by: Michal Wasilewski <[email protected]>

Author: mwasilew2

docs/concepts/authorization/assigning-roles-api-keys.md

@@ -1,4 +1,4 @@
-# API Key Role Bindings
+# API key role bindings
 
 [API](./../../integrations/api.md#spacelift-api-key-token) keys can receive roles through three methods:
 
@@ -9,9 +9,9 @@
 !!! note "Immediate Role Changes"
     Except for Login Policies, role assignments and changes to roles take effect immediately (they force re-authentication if needed).
 
-## Assigning Roles
+## Assigning roles
 
-### Assigning Roles to API Keys directly using the Web UI
+### Assigning roles to API keys directly using the web UI
 
 1. Prerequisites
     1. The selected management strategy for your organization must be User Management
@@ -32,11 +32,11 @@
     2. **Select Space**: Choose the space where the role applies
     3. **Save Assignment**: Confirm the role assignment
 
-### Assigning Roles to API Keys directly using the terraform provider
+### Assigning roles to API keys directly using the terraform provider
 
 Refer to [Spacelift Terraform provider documentation](https://registry.terraform.io/providers/spacelift-io/spacelift/latest/docs) for more details).
 
-### Assigning Roles to API Keys directly using the Login Policies
+### Assigning roles to API keys directly using the login policies
 
 1. Prerequisites
     1. The selected management strategy for your organization must be Login Policies
@@ -58,7 +58,7 @@ roles[space][role_id] {
 }
 ```
 
-#### By Key Name
+#### By key name
 
 ```opa
 package spacelift
@@ -75,7 +75,7 @@ roles["infrastructure"]["provisioner-role-id"] {
 }
 ```
 
-#### By Key Pattern
+#### By key pattern
 
 ```opa
 package spacelift
@@ -92,7 +92,7 @@ roles["monitoring"]["reader-role-id"] {
 }
 ```
 
-#### Separate Keys per Environment
+#### Separate keys per environment
 
 ```opa
 package spacelift
@@ -119,7 +119,7 @@ roles["production"]["limited-deployer-role-id"] {
 }
 ```
 
-#### Multi-Environment Keys
+#### Multi-environment keys
 
 ```opa
 package spacelift
@@ -137,7 +137,7 @@ roles[space]["cross-env-role-id"] {
 }
 ```
 
-#### CI/CD Pipeline Keys
+#### CI/CD pipeline keys
 
 ```opa
 package spacelift
@@ -160,7 +160,7 @@ roles["applications"]["jenkins-deployer-role-id"] {
 }
 ```
 
-#### Infrastructure Tools
+#### Infrastructure tools
 
 ```opa
 package spacelift
@@ -183,7 +183,7 @@ roles["kubernetes"]["k8s-operator-role-id"] {
 }
 ```
 
-#### Conditional API Key Access
+#### Conditional API key access
 
 ```opa
 package spacelift
@@ -212,7 +212,7 @@ is_deployment_window {
 }
 ```
 
-#### IP-Restricted API Keys
+#### IP-restricted API keys
 
 ```opa
 package spacelift
@@ -238,11 +238,11 @@ is_secure_network {
 }
 ```
 
-### Assigning Roles to API Keys using IdP Groups
+### Assigning roles to API keys using IdP groups
 
 See [IdP Group Role Bindings](assigning-roles-groups.md) for details on how to assign roles to IdP groups. Once a role is assigned to an IdP group, all actors (api keys and users that your identity provider reports as being members of that group) will inherit the assigned roles.
 
-## Removing An API Key Role Binding
+## Removing an API key role binding
 
 1. Navigate to API Key Management
     1. Click your name in the bottom left corner of the Spacelift interface
@@ -258,15 +258,15 @@ See [IdP Group Role Bindings](assigning-roles-groups.md) for details on how to a
     2. Click the **Unassign** button from the dropdown
     3. Confirm the removal
 
-## Multiple Roles
+## Multiple roles
 
 Actors can have multiple roles across different spaces:
 
 - Different roles in different spaces for varied access levels
 - Multiple roles in the same space (permissions are additive)
 - Roles inherited from group membership plus individual assignments
 
-## Getting Role IDs
+## Getting role IDs
 
 To use custom roles in login policies, you need their role IDs:
 
@@ -277,7 +277,7 @@ To use custom roles in login policies, you need their role IDs:
 
 ## Troubleshooting
 
-### Common Issues
+### Common issues
 
 **API Key Authentication Failures**:
 

docs/concepts/authorization/assigning-roles-groups.md

@@ -1,10 +1,10 @@
-# IdP Group Role Bindings
+# IdP group role bindings
 
 IdP groups can receive roles through direct group assignment. Assign roles to the entire group, which automatically applies to all members of that group.
 
-## Assigning Roles
+## Assigning roles
 
-### Assigning Roles to IdP Groups using the Web UI
+### Assigning roles to IdP groups using the web UI
 
 1. Prerequisites
     1. The selected management strategy for your organization must be User Management
@@ -26,11 +26,11 @@ IdP groups can receive roles through direct group assignment. Assign roles to th
     2. Click the **Manage Roles** button
     3. This opens the group role assignment interface
 
-### Assigning Roles to IdP Groups using the terraform provider
+### Assigning roles to IdP groups using the terraform provider
 
 Refer to the [Spacelift Terraform provider documentation](https://registry.terraform.io/providers/spacelift-io/spacelift/latest/docs/resources/idp_group_mapping) for detailed instructions on creating IdP group mappings programmatically.
 
-### Assigning Roles to IdP Groups using the Login Policies
+### Assigning roles to IdP groups using the login policies
 
 1. Prerequisites
     1. The selected management strategy for your organization must be Login Policies
@@ -49,7 +49,7 @@ roles[space][role_id] {
 }
 ```
 
-#### Individual Group Assignment
+#### Individual group assignment
 
 ```opa
 package spacelift
@@ -67,7 +67,7 @@ roles["frontend"]["developer-role-id"] {
 }
 ```
 
-#### Multiple Teams, Same Role
+#### Multiple teams, same role
 
 ```opa
 package spacelift
@@ -89,7 +89,7 @@ roles["infrastructure"]["platform-role-id"] {
 }
 ```
 
-#### Hierarchical Team Access
+#### Hierarchical team access
 
 ```opa
 package spacelift
@@ -116,7 +116,7 @@ roles[space]["team-lead-role-id"] {
 }
 ```
 
-#### Department-Based Access
+#### Department-based access
 
 ```opa
 package spacelift
@@ -141,7 +141,7 @@ roles[space]["security-auditor-role-id"] {
 }
 ```
 
-#### Project and Functional Groups
+#### Project and functional groups
 
 ```opa
 package spacelift
@@ -169,7 +169,7 @@ roles[space]["security-role-id"] {
 }
 ```
 
-#### Multi-Condition Team Assignment
+#### Multi-condition team assignment
 
 ```opa
 package spacelift
@@ -188,7 +188,7 @@ roles["production"]["prod-deployer-role-id"] {
 
 ## Troubleshooting
 
-### Common Issues
+### Common issues
 
 **Group Permissions Not Working**:
 
@@ -203,7 +203,7 @@ roles["production"]["prod-deployer-role-id"] {
 - Permissions are additive across group memberships
 - Regular audit of group role combinations
 
-### Debugging Steps
+### Debugging steps
 
 1. **Verify Group Membership**: Check user is member of expected groups in IdP
 2. **Validate Role Assignment**: Confirm group has correct role assignments

docs/concepts/authorization/assigning-roles-users.md

@@ -1,4 +1,4 @@
-# User Role Bindings
+# User role bindings
 
 Users can get permissions from three sources:
 
@@ -9,9 +9,9 @@ Users can get permissions from three sources:
 !!! note "Immediate Role Changes"
     Except for Login Policies, role assignments and changes to roles take effect immediately (they force re-authentication if needed).
 
-## Assigning Roles
+## Assigning roles
 
-### Assigning Roles to Users directly using the Web UI
+### Assigning roles to users directly using the web UI
 
 1. Prerequisites
     1. The selected management strategy for your organization must be User Management
@@ -32,11 +32,11 @@ Users can get permissions from three sources:
     2. **Select Space**: Choose the space where the role applies
     3. **Save Assignment**: Click **Add** to confirm the assignment
 
-### Assigning Roles to Users directly using the terraform provider
+### Assigning roles to users directly using the terraform provider
 
 Refer to [Spacelift Terraform provider documentation](https://registry.terraform.io/providers/spacelift-io/spacelift/latest/docs) for more details).
 
-### Assigning Roles to Users directly using the Login Policies
+### Assigning roles to users directly using the login policies
 
 1. Prerequisites
     1. The selected management strategy for your organization must be Login Policies
@@ -54,7 +54,7 @@ allow { input.session.member }
 roles[space_name][role_id] { condition }
 ```
 
-#### Individual User Assignment
+#### Individual user assignment
 
 ```opa
 package spacelift
@@ -76,7 +76,7 @@ roles["staging"]["developer-role-id"] {
 }
 ```
 
-#### Multiple Users with Same Role
+#### Multiple users with same role
 
 ```opa
 package spacelift
@@ -96,7 +96,7 @@ roles["production"]["senior-developer-role-id"] {
 }
 ```
 
-#### Environment-Based Access
+#### Environment-based access
 
 ```opa
 package spacelift
@@ -123,7 +123,7 @@ roles[space]["lead-developer-role-id"] {
 }
 ```
 
-#### Time-Based Access
+#### Time-based access
 
 ```opa
 package spacelift
@@ -151,7 +151,7 @@ is_business_hours {
 weekend := {"Saturday", "Sunday"}
 ```
 
-#### IP-Based Access
+#### IP-based access
 
 ```opa
 package spacelift
@@ -175,11 +175,11 @@ is_office_network {
 }
 ```
 
-### Assigning Roles to Users via IdP Groups
+### Assigning roles to users via IdP groups
 
 See [IdP Group Role Bindings](assigning-roles-groups.md) for details on how to assign roles to IdP groups. Once a role is assigned to an IdP group, all actors (api keys and users that your identity provider reports as being members of that group) will inherit the assigned roles.
 
-## Removing A User Role Binding
+## Removing a user role binding
 
 1. Navigate to User Management:
     1. Click your name in the bottom left corner of the Spacelift interface
@@ -195,15 +195,15 @@ See [IdP Group Role Bindings](assigning-roles-groups.md) for details on how to a
     2. Click the **Unassign** button from the dropdown
     3. Confirm the removal
 
-## Multiple Roles
+## Multiple roles
 
 Actors can have multiple roles across different spaces:
 
 - Different roles in different spaces for varied access levels
 - Multiple roles in the same space (permissions are additive)
 - Roles inherited from group membership plus individual assignments
 
-## Getting Role IDs
+## Getting role IDs
 
 To use custom roles in login policies, you need their role IDs:
 
@@ -214,7 +214,7 @@ To use custom roles in login policies, you need their role IDs:
 
 ## Troubleshooting
 
-### Common Issues
+### Common issues
 
 **User Cannot See Resources**: