Is there a plan to add models/schemas? about developer-portal-starter HOT 6 CLOSED

@DavidBiesack we have this "Models" feature in progress. We never implemented it as we display models inline but we had some requests like yours to be able to link to models externally.

We're working on it. ETA is hopefully ~4-5 weeks from now depending on the situation.

from developer-portal-starter.

@adamaltman I think we actually already resolved this issue, as upgrading to the later versions of the developer portal that included the updates to use Reference Docs 2.x did the trick for us. Now everything is working as it should. 👍🏻🙂

from developer-portal-starter.

@DavidBiesack The schemas are shown for responses, as well as for request bodies, as long as they are defined in the API reference doc. I believe this should also be the case for schemas/models that are linked using an external ref.

It looks like on the example, the Models section is created by defining it in the sidebars.yaml with links to the tags in the openapi.yaml.

Also, please bear in mind you are commenting on a closed issue, not to mention current events happening in Ukraine (where much of the Redocly team is based), so the Redocly folks may not respond here, or at least not right away.

🇺🇦 ❤️ #standwithukraine

from developer-portal-starter.

@AX-LLaidley happy to walk you through this. We do have support for polymorphism. Reach out to team at redocly dot com.

from developer-portal-starter.

Is there a demo or other example of this? https://redocly.github.io/redoc/ does not render a "Schemas" or "Models" section when I try it. Perhaps that is just the open source redoc tool, not the dev portal commercial product? I looked at some of the redoc.ly customer sites and don't see sections for Models. I'm considering redocly but it's crucial that I can link to anchors for the models -- we cite/link to the models that reside inside our API reference doc from other documents.

from developer-portal-starter.

ukraine heart #standwithukraine

Thank you @AX-LLaidley !

This component can be used to display schemas on pages: https://redoc.ly/docs/developer-portal/components/json-schema/

from developer-portal-starter.