[WIP] Add swagger config

[vickyhella]

This PR:

• Adds the openapi plugin 2.0.0-beta.3.
• Bumps docusaurus to 2.4.1
• Bumps react to 18.2.0
• Adds swagger API config to the docusaurus.config.js file
• Generates API mdx files

The mdx files in the docs/api folder were generated by running the yarn docusaurus gen-api-docs all command.

Compatibility:
Docusaurus 2.3.1 works well with openapi 2.0.0-beta.1.
Docusaurus 2.2.0 works well with openapi 1.4.2.
Docusaurus 2.4.1 doesn't work with openapi 2.0.0-beta.2 or 2.0.0-beta.3.
Update: after upgrading react to the latest 18.2.0, docusaurus and openapi can be bumped to the latest 2.4.1 and 2.0.0-beta.3.

Related issue:

• [Doc] Add API docs harvester#3042

What needs to be done:

• Modify api/petstore.yaml and docusaurus.config.js based on our actual needs (see the plugin documentation for more info). Note that the current api/petstore.yaml file is an example file for reference only.

• Run yarn docusaurus gen-api-docs all, which generates MDX files in the docs/api folder.

• It'll be better if we can split the yaml file into several files by category, because the plugin actually generates one page for each API, which might be hard to read as we have hundreds of APIs.

  

References

• Plugin documentation: https://docusaurus-openapi.tryingpan.dev/
• Official demo: https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/tree/main/demo
• Example json/yaml config: https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/tree/main/demo/examples
• Example docusaurus.config.js config: https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/blob/main/demo/docusaurus.config.js

[netlify]

✅ Deploy Preview for harvester-preview ready!

Name	Link
🔨 Latest commit	967fd41
🔍 Latest deploy log	https://app.netlify.com/sites/harvester-preview/deploys/64daf17b853a3a18bb7522d5
😎 Deploy Preview	https://64daf17b853a3a18bb7522d5--harvester-preview.netlify.app

---

[vickyhella]

@guangbochen Already updated the API titles and adjusted the sidebar. Please help take a look at the production build as mentioned before. Thanks!

[vickyhella]

Closing in favor of #388