Render OpenAPI spec as Ref Guide page

[epugh]

https://issues.apache.org/jira/browse/SOLR-17395

Description

POC of using the https://stoplight.io/open-source/elements library to render our OpenAPI specfication in Ref Guide.

Solution

This is just a draft, and I don't even know if it should be in Ref Guide or standalone site? I tried Redoc which I've used before but couldn't get the magic to work.

After building the site you need to run python3 -m http.server 8080 --directory solr/solr-ref-guide/build/site and hit port 8080.. The docs only work in a HTTP environment.

Tests

manual

./gradlew clean
./gradlew :solr:solr-ref-guide:buildLocalSite
python3 -m http.server 8080 --directory solr/solr-ref-guide/build/site

[epugh]

This whole toplevel nav coupld be moved under somewhere else if we wanted..

[epugh]

Example of UI rendered:

[solrbot]

Cool