Update schema docs to include information about OCI registries for helm charts

[lucasrod16]

Description

• Updates schema docs to include information about OCI registries for helm charts
• Updates contributing guide to include information about regenerating schema and docs when an update to the docs is made

Related Issue

Fixes #1463

Type of change

• Other (security config, docs update, etc)

Checklist before merging

• Test, docs, adr added or updated as needed
• Contributor Guide Steps followed

[netlify]

✅ Deploy Preview for zarf-docs ready!

Name	Link
🔨 Latest commit	7f734e4
🔍 Latest deploy log	https://app.netlify.com/sites/zarf-docs/deploys/6421cf78495bdf0008a05f05
😎 Deploy Preview	https://deploy-preview-1464--zarf-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site settings.

[Racer159]

@lucasrod16 looks like you need to run make docs-and-schema and commit the generated changes

[lucasrod16]

@lucasrod16 looks like you need to run make docs-and-schema and commit the generated changes

@Racer159 Ahh I see, thanks! Is the purpose of that to ensure that all of the right references got updated when there's an update to the docs? I can add that step and describe when it should be used to the CONTRIBUTING.md if desired.

[lucasrod16]

@Racer159 when I'm running make docs-and-schema it's stripping away the description after the first comma to be The URL of the OCI registry. I'll go ahead and put this PR in draft status until I resolve it. Any suggestions?

[Racer159]

@lucasrod16 yeah the reason it cuts it off is because the values there are comma separated - to do a description with commas you have to use jsonschema_description as in: https://github.com/defenseunicorns/zarf/blob/cbf3c04dbaa568f0010c4dfb2db1f317ead3f9c3/src/types/package.go#L30

And if you can add a reference to that in the contributing guide that would be great! The purpose of make docs-and-schema is to update our auto generated docs - we force people to do this (rather than CI) so that there is a git commit signature from a person on the commit for better traceability (rather than an non-person entity Github CI token)

[lucasrod16]

@lucasrod16 yeah the reason it cuts it off is because the values there are comma separated - to do a description with commas you have to use jsonschema_description as in:

https://github.com/defenseunicorns/zarf/blob/cbf3c04dbaa568f0010c4dfb2db1f317ead3f9c3/src/types/package.go#L30

And if you can add a reference to that in the contributing guide that would be great! The purpose of make docs-and-schema is to update our auto generated docs - we force people to do this (rather than CI) so that there is a git commit signature from a person on the commit for better traceability (rather than an non-person entity Github CI token)

@Racer159 Thanks! I made the jsonschema_description update and added examples as well. I will also add a section about running make docs-and-schema in the contributing guide

[lucasrod16]

@Racer159 this is ready for review whenever you get the chance

[Racer159]

tiny suggestion but figured more info could be valuable (in case someone ran into this on our command docs too)

[Racer159]

lgtm! thanks!