Update product-based-permissions

[tfordcodat]

Description

• Include a summary of the new content you're adding or the reason for the change.
• Include relevant context.
• Do not link to work items.
• Any PNG images should be compressed using Tiny PNG or equivalent.

Type of change

Please delete options that are not relevant.

• New document(s)/updating existing
• Fixes
• Styling
• Bug fix (non-breaking change which fixes an issue)

Reviews and merging

You are responsible for getting your PR merged. Address review comments promptly and make sure to merge the PR when ready.
Feel free to 'Enable automerge' - your PR will automatically merge when accepted and passing the build.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
codat-docs	Ready	Preview	Comment	Oct 14, 2025 11:47am

[andy-white-hat]

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

Status	Scanner	Critical	High	Medium	Low	Total (0)
✅	Licenses	0	0	0	0	0 issues
✅	Open Source Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

[pmckinney-codat]

@tfordcodat just fyi, I'm working on this locally to see if I can understand why the page isn't showing up

[github-actions]

Overall readability score: 57.67 (🟢 +0.01)

File	Readability
product-based-permissions.md	65.17 (-)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
product-based-permissions.md	65.17	51.55	8.83	9.9	11.93	7.37
	-	-	-	-	-	-

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	57.67	48.4	10.39	11.63	12.15	7.84
	🟢 +0.01	🟢 +0.01	🟢 +0	🟢 +0	🟢 +0	🟢 +0

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less

[github-actions]

Link check results for preview deployment (https://codat-docs-git-tfordcodat-patch-2-codat.vercel.app):

[
  "[401] https://codat-docs-git-tfordcodat-patch-2-codat.vercel.app/"
]

[pmckinney-codat]

@tfordcodat please review the recent changes to confirm you're happy with them: https://codat-docs-git-tfordcodat-patch-2-codat.vercel.app/enterprise/tech-overview/security/product-based-permissions

Reason issues were happening:

1. It wasn't added to the sidebar so users couldn't navigate to it (here)
2. File wasn't created as a .md file which means it wasn't available (here)
3. File needed a title and description in order to display correctly (here)

[pmckinney-codat]

@tfordcodat I disabled auto merge and approved the PR so please merge when you confirm you're happy with how it's displayed

[pmckinney-codat]

cc @dcoplowe for visibility and extra review if needed

[tfordcodat]

thanks for the detail @pmckinney-codat - good to know for next time!

I am waiting for access to be granted to view in Vercel - do you know who could give that?