How to specify endpoint description and name?

[ChillFish8]

Hi! Loving poem and the open api integration but one thing that's been plaguing me is that redoc gets populated with most info but doesn't populate the endpoint name.

I also couldn't find a way to manually add this (#[oai]) came to mind but my vague attempts didn't work (although as future improvement it would be awsome if you could specify addition openapi attributes via the function's macro.

example code:

pub struct UsersApi;

#[OpenApi]
impl UsersApi {
    #[oai(path = "/@me", method = "get")]
    pub async fn user(
        &self,
        session: Data<&Session>,
        token: TokenBearer,
    ) -> Result<Json<UserPayload>> {
        todo!()
    }
}```

[sunli829]

Do it like this:

pub struct UsersApi;

#[OpenApi]
impl UsersApi {
    /// description
    #[oai(path = "/@me", method = "get")]
    pub async fn user(
        &self,
        session: Data<&Session>,
        token: TokenBearer,
    ) -> Result<Json<UserPayload>> {
        todo!()
    }
}

[ChillFish8]

>-< Kind of embarrassed that I never thought about doing that.

[ChillFish8]

Okay this works for the summary which is awesome! But how can you add a description if the rust side's description is produced as the title?

[sunli829]

The first line is the summary, and the following is the description. 😁

pub struct UsersApi;

#[OpenApi]
impl UsersApi {
    /// summary
    ///
    /// description
    /// A
    /// B
    #[oai(path = "/@me", method = "get")]
    pub async fn user(
        &self,
        session: Data<&Session>,
        token: TokenBearer,
    ) -> Result<Json<UserPayload>> {
        todo!()
    }
}

[ChillFish8]

Oh perfect! Thank you so much!