gerlowskija commented on PR #4291: URL: https://github.com/apache/solr/pull/4291#issuecomment-4672912808
> I wonder if a better fit than ref-guide is to add it as part of or alongside the Admin UI on /api-docs/ or something? My original intention for this JIRA was more to generate a bunch of small snippets using `openapi-generator` that would then be referenced on individual sections of our ref-guide (via the `include::` syntax that lets you bring in content from other files). IMO that's still the best option as it'd allow us to reduce what we're currently maintaining "by hand". But there's still lots of value in a parallel `/api-docs/` endpoint that exposes a Redocly/Swagger site totally separate from the ref-guide. Either of those approaches would be a "Good Thing" IMO. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
