Build docs with rapi docs and swagger docs features enabled

[ThouCheese]

It is useful to display the structs and functions in the swagger and rapi doc modules on docs.rs. I also added an example to the rapi-docs module and fixed a couple of typos in Cargo.toml.

[Sollimann]

Is it possible to generate a openapi.json or openapi.yaml file that will be saved to file inside of the folder, so that I can copy it and re-use for autogenerate stubs for e.g python-api-client-sdk ? Right now, it just host the swagger-page using the openapi.json file, but I also want to be able to have the file itself. @ThouCheese

[ralpha]

Is it possible to generate a openapi.json or openapi.yaml file that will be saved to file inside of the folder, so that I can copy it and re-use for autogenerate stubs for e.g python-api-client-sdk ? Right now, it just host the swagger-page using the openapi.json file, but I also want to be able to have the file itself.

Although not related to this PR. But yes this is possible, but is easiest to do since version 0.8.0-rc.1. You can do this by using:
https://docs.rs/rocket_okapi/0.8.0-rc.1/rocket_okapi/macro.openapi_spec.html

This macro will return an OpenApi struct which implements Serialize and can thus be used with all Serde libraries, like serde_json or serde_yaml

let settings = rocket_okapi::settings::OpenApiSettings::new();
let spec = rocket_okapi::openapi_spec![get_message, post_message](settings);
let json_string = serde_json::to_string(&spec)?;
let yaml_string = serde_yaml::to_string(&spec)?;
// Just write this String to file.

[ralpha]

PR looks good

[Sollimann]

@ralpha thank you! :) ps, sorry for hijacking the PR