Thanks so much for your thoughtful feedback and giving our first open sourced tool a try. Please don't hesitate to reach out here or email me directly at marc@scalar.com if you have any feedback or if I can help you in any way shape or form with your API.
That said, I don't just use Open API for documentation. I use it to generate clients and servers so that my customers can easily upgrade versions or generate them themselves. Are there any plans to formulate examples from those generated clients? That, today, has to be hand annotated if you want the custom examples (beyond REST) to appear in the API documentation.
Our plans are to make it easier to integrate with existing SDK generation tools so you can use them inside of our API docs.
https://www.speakeasyapi.dev/ is a really great platform and I think we can integrate with them and have examples from custom SDKs.
In the scenario with custom domains, we would have to rely on docstrings or comments depending on the language, I'll need more thought on that