docs: fixes 3084

[melissahenderson]

This PR covers doc issues that were discussed during a meeting with Max on Nov. 05, 2024.

@mkurapov Tagging you because of the YAML updates. Also, the OpenAPI spec for IdP is missing Continue Grant POST /interact/{id}/{nonce}. Is that intentional or should I create an issue for it?

[netlify]

✅ Deploy Preview for brilliant-pasca-3e80ec ready!

Name	Link
🔨 Latest commit	c884630
🔍 Latest deploy log	https://app.netlify.com/sites/brilliant-pasca-3e80ec/deploys/672cbfab0bbc0000080bf47f
😎 Deploy Preview	https://deploy-preview-3088--brilliant-pasca-3e80ec.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 configuration.

[mkurapov]

Also, the OpenAPI spec for IdP is missing Continue Grant POST /interact/{id}/{nonce}. Is that intentional or should I create an issue for it?

Continue Grant POST is for the Open Payments Auth API, so shouldn't be in the IdP spec

[mkurapov]

was this auto-formatted?

[melissahenderson]

When we run prettier on the docs, it adds a bunch of extra spaces within all the markdown table columns and rows. That makes it harder for the writers to 'read' the tables and edit them later. Sarah's given us a temporary workaround where prettier will ignore the tables (actually, maybe all the doc files) and keep our original formatting. So this was me putting the table back to its original formatting.