Tag description

[barvirm]

Is it possible to create a tag description with the current API?

[ralpha]

Tags, yes
Tag description, no, not using a macro at least.

You can merge multiple OpenAPI specs like here: https://github.com/GREsau/okapi/blob/master/examples/custom_schema/src/main.rs#L61 or using https://docs.rs/rocket_okapi/0.8.0-rc.1/rocket_okapi/macro.openapi_get_routes_spec.html
Just add your tags and there description.

okapi/okapi/src/openapi3.rs

Line 59 in e686b44

pub tags: Vec<Tag>,

OpenApi {
    tags: vec![
        Tag {
            name: "Message".to_owned(),
            description: Some("Here is my desc".to_owned()),
        },
        // ...
    ]
}

If you want to add this using macros, PR's are welcome see:

okapi/rocket-okapi-codegen/src/openapi_attr/mod.rs

Lines 19 to 24 in e686b44

	struct OpenApiAttribute {
	pub skip: bool,
	#[darling(multiple, rename = "tag")]
	pub tags: Vec<String>,
	}