Is it possible to add enpoint description?

[wkargul]

Is it possible to add such a description to the endpoint?

[wkargul]

Resolved this!

I discovered that the distinction between summary and description in poem-openapi is based on the /n/n split. This is outlined in the source code, specifically at poem-openapi-derive/src/utils.rs#L63.

To illustrate with the given example, it would be structured like this:

/// Endpoint for deleting many resources by ids body. <- summary
/// <- necessary gap
/// <- necessary gap
/// Endpoint for deleting many resources by ids body. <- description for your method
#[oai(path = "/timeseries/delete", method = "post")]