docs(other): alternative respect usage code walkthrough article

[DmitryAnansky]

What/Why/How?

Alternative respect usage code walkthrough article.

Reference

Testing

Screenshots (optional)

Check yourself

• Code is linted
• Tested
• All new/updated code is covered with tests

Security

• Security impact of change has been considered
• Code follows company security practices and guidelines

[redocly]

marketing-site AI Review: 🟢 Completed

Reunite Bot has reviewed your changes and found 13 potential issue(s).

Note

Low Risk

The changes are entirely confined to documentation and example files within the learn/arazzo directory. There is no modification to the core system, application logic, or build configuration, meaning there is no risk to production behavior or functionality.

Overview

Refactors the Arazzo "Respect" usage articles to implement an alternative, interactive code walkthrough format.

• Migrates inline OpenAPI and Arazzo YAML snippets into standalone external files within new _filesets directories.
• Annotates the new YAML files with # @chunk tags to break down complex configurations into digestible steps.
• Updates api-contract-testing-01.md and oauth2-authorization-02.md to use the {% code-walkthrough %} and {% step %} components, providing a better side-by-side reading experience for the tutorials.

[redocly]

The OAuth2Client schema exposes registrationAccessToken. This is a highly sensitive token that should be handled with care and typically not returned unless necessary for client management (API3:2023).