Have all API help in OpenAPI menu, or have OpenAPI rendering in mkdocs

[alexgarel]

What

• Currently, if you access https://openfoodfacts.github.io/openfoodfacts-server, you can see the tutorial, API intro, etc. but as soon as you dive into the API spec https://openfoodfacts.github.io/openfoodfacts-server/reference/api, the menu on the left only contains API points.
• We should either include a link to intro + tutorials + cheasheet, etc in the redoc menu, or render the doc inside mkdocs.

Part of

• 📝 API Documentation using OpenAPI (tracker) #7446

[alexgarel]

@teolemon @Roxie-32 including external markdown in redoc is really easy indeed.
See https://redocly.com/docs/api-reference-docs/guides/embedded-markdown/

[alexgarel]

There also seems to be a sidebars.yaml to configure the left menu (not sure if it works in OSS version).

[alexgarel]

I tried and sidebars in the leftmenu is a feature which is NOT available in community edition !

I have two choices now:

• either we use a specific template with javascript to inject the menu entries we want (that seems doable, but I'm not sure)
• either we try https://rapidocweb.com/ which is fully Open Source, but I yet have to see how to use it.

[github-actions]

This issue has been open 90 days with no activity. Can you give it a little love by linking it to a parent issue, adding relevant labels and projets, creating a mockup if applicable, adding code pointers from https://github.com/openfoodfacts/openfoodfacts-server/blob/main/.github/labeler.yml, giving it a priority, editing the original issue to have a more comprehensive description… Thank you very much for your contribution to 🍊 Open Food Facts