Give x-fern-examples separate fields for sample-name and language

[cwcowell]

Feature Description

We add sample code for each API operation's x-fern-examples > code-samples field in openapi.yaml. This is successfully shown to the user in a sample code box.

We include 3 types of sample code in that box for each API operation, showing 3 ways of accessing that API operation:

• Make a direct API call with curl. For this sample code, we set the code sample’s language field to curl
• Make a direct API call with Python. For this sample code, we set the code sample’s language field to Python API
• Make an API call with the Python SDK. For this sample code, we set the code sample’s language field to Python SDK

This approach mostly works: we see all 3 values in the dropdown, and sample code for each shows correctly.

The one problem we have with this approach stems from the fact that for each code sample, the x-fern-examples > code-samples > language field sets both the dropdown option name and the language. The former is needed to populate the dropdown picker, and the latter is needed to figure how to do syntax highlighting for the sample code.

This means that if we set the language field to Python API or Python SDK, it can’t tell what language the sample code is in, so it disables syntax highlighting.

To preserve syntax highlighting, we’d like a way to specify the dropdown option name separately from the language of the sample code.

For example, maybe have these 2 fields for each piece of sample code in openapi.yaml:

• x-fern-examples > code-samples > sample-name which might be set to “Python SDK"
• x-fern-examples > code-samples > language which might be set to “python”

In openapi.yaml the proposed scheme might look like this:

      x-fern-examples:
        - code-samples:
            - sample-name: curl
              language: bash
              code: curl foo
            - sample-name: Python API
              language: python
              code: print("bar")
            - sample-name: Python SDK
              language: python
              code: print("baz")

Use Case

see above

Proposed Experience (Optional)

see above

Alternatives Considered (Optional)

No response