Open
Conversation
Contributor
Vercel Previews Deployed
|
trujillo-adam
changed the title
Contributor
Broken Link CheckerThis PR contains broken links, but won't be blocked. Use this report to improve content quality: Quick Actions
Need Help?
Internal LinksExternal Links |
mattschouten
approved these changes
Apr 3, 2026
Contributor
mattschouten
left a comment
mattschouten
left a comment
There was a problem hiding this comment.
A couple small changes and thoughts. Approving so you can merge when ready.
...terraform-docs-common/docs/cloud-docs/users-teams-organizations/permissions/organization.mdx
Outdated
Show resolved
Hide resolved
| ### Delegate policy overrides | ||
|
|
||
| Allow project and workspace managers to grant override permissions for **Soft mandatory** policy evaluations. When this setting is enabled, overriding failed policy evaluations is disabled by default. Project and workspace managers must manually enable the **Allow policy overrides** setting in their projects and workspaces. | ||
|
|
Contributor
There was a problem hiding this comment.
These sections don't add much information beyond what's in the table already. What do you think about moving the "Refer to the projects and workspaces..." bit to the table, and removing these sections?
(I'm ok if not)
Contributor
Author
There was a problem hiding this comment.
I'm just following the template we set up. The separate headings also give us direct links to each setting.
content/terraform-docs-common/docs/cloud-docs/users-teams-organizations/permissions/project.mdx
Outdated
Show resolved
Hide resolved
...nt/terraform-docs-common/docs/cloud-docs/users-teams-organizations/permissions/workspace.mdx
Outdated
Show resolved
Hide resolved
...aform-docs-common/docs/cloud-docs/workspaces/policy-enforcement/manage-policy-sets/index.mdx
Outdated
Show resolved
Hide resolved
| | --- | --- | | ||
| | [No policy overrides](#no-policy-overrides) | Teams can’t override failed **Soft mandatory** policy evaluations. | | ||
| | [Delegate policy overrides](#delegate-policy-overrides) | Allow project and workspace managers to grant override permissions for **Soft mandatory** policy evaluations. When this setting is enabled, the ability to override failed policy evaluations is disabled by default. Project and workspace managers must manually enable the **Allow policy overrides** setting in their projects and workspaces. | | ||
| | [Manage policy overrides](#manage-policy-overrides) | Team members can override failed **Soft mandatory** policy evaluations in all workspaces. | |
There was a problem hiding this comment.
Is it also worth making it explicit that Manage policy overrides gives read access to all workspaces in the organization, while Delegate policy overrides does not? The read all workspaces behavior of the existing setting has been a big pain point for customers, so I'm wondering if we can highlight how Delegate is better.
Contributor
Author
There was a problem hiding this comment.
Added this to the more detailed description linked from this table.
|
пт, 3 квіт. 2026 р., 23:02 користувач github-actions[bot] <
***@***.***> пише:
*github-actions[bot]* left a comment (hashicorp/web-uni
<#2152?email_source=notifications&email_token=B3SYZBQ2LFQPXMNVYSJKFBL4UAKELA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIMJYGQ4TSNRZHE32M4TFMFZW63VKON2WE43DOJUWEZLEUVSXMZLOOS2XA4S7MNXW23LFNZ2F633QMVXF6Y3MNFRWW#issuecomment-4184996997>
fied- docs#2152)
… <#2152?email_source=notifications&email_token=B3SYZBQ2LFQPXMNVYSJKFBL4UAKELA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIMJYGQ4TSNRZHE32M4TFMFZW63VKON2WE43DOJUWEZLEUVSXMZLOOS2XA4S7MNXW23LFNZ2F633QMVXF6Y3MNFRWW#issuecomment-4184996997>
Broken Link Checker
*This PR contains broken links, but won't be blocked.* Use this report to
improve content quality:
Quick Actions
- *Internal links* (HashiCorp sites): Please fix these - they impact
user experience
- *External links*: Consider if these are essential or can be
updated/removed
- *Temporary issues*: External sites may recover - check again before
merging
Need Help?
- Review our Broken Link Monitoring doc s
<http://.github/BROKEN_LINK_MONITORING.md>
- Check the monthly production report
<https://github.com/hashicorp/web-unified-docs/issues?q=label%3Alink-checker-report+is%3Aopen>
for context
------------------------------
Internal Links
Full Github Acti ons output
<https://github.com/hashicorp/web-unified-docs/actions/runs/23959741423?check_suite_focus=true>
External Links
Full Github AC tions output
<https://github.com/hashicorp/web-unified-docs/actions/runs/23959741423?check_suite_focus=true>
—
Reply to this email directly, view it on GitHub
<#2152?email_source=notifications&email_token=B3SYZBQ2LFQPXMNVYSJKFBL4UAKELA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIMJYGQ4TSNRZHE32M4TFMFZW63VKON2WE43DOJUWEZLEUVSXMZLOOS2XA4S7MNXW23LFNZ2F633QMVXF6Y3MNFRWW#issuecomment-4184996997>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/B3SYZBVQIVYG36LUPLBLMO34UAKELAVCNFSM6AAAAACXMCYVPSVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DCOBUHE4TMOJZG4>
.
Yo u are receiving this because you are subscribed to this thread.Message
ID: ***@***.***>
|
...nt/terraform-docs-common/docs/cloud-docs/users-teams-organizations/permissions/workspace.mdx
Outdated
Show resolved
Hide resolved
trujillo-adam
commented
Apr 3, 2026
...terraform-docs-common/docs/cloud-docs/users-teams-organizations/permissions/organization.mdx
Show resolved
Hide resolved
Co-authored-by: Matt Schouten <matt.schouten@gmail.com> Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR adds documentation for the new set of permissions that allow organization admins to disable soft mandatory policy failure overrides, delegate authority to project and workspace managers, or allow all soft mandatory policy failure overrides.