User story: custom code samples

[rattrayalex]

User Story Description

As an API provider who offers SDKs for my API,

I want to include code snippets demonstrating those SDKs for each API request,

so I can make my users integrations much easier.

Acceptance Criteria

• Read from a property like x-codeSamples in the OAS for each operation with something like a hash like {go: '…', node: '…', python: '…'} (no opinions here)
• Display that instead of the default for the given language

Notes

1. this was originally filed within Update code samples, support typescript, add custom code samples #2175 which was closed as stale
2. This is a feature that ReadMe.com offers as x-readme.code-samples, and I think Redoc supports as well.

Sprint Ready Checklist

• Acceptance criteria defined
• Team understands acceptance criteria
• Team has defined solution / steps to satisfy acceptance criteria
• Acceptance criteria is verifiable / testable
• External / 3rd Party dependencies identified

[weyert]

@rattrayalex I have been working on a PR to support an initial round of the x-codeSamples vendor extension

[github-actions]

This ticket has been labeled jira. A tracking ticket in Stoplight's Jira (STOP-492) has been created.

[rattrayalex]

I assume this is now fixed in #2574 – thank you @weyert !