Is there a way to customize documentation for derive?

[rw]

First of all, I want to say thank you for this fantastic library!

The Rust types I'm using with schemars already have lots of doc comments. I'd like schemas, via derive(JsonSchema), to skip those doc comments (they are too long). Ideally, I'd like to configure my own comments for just json schema generation. Is this possible?

Thanks!

[GREsau]

It's not currently possible, but adding a new option to SchemaSettings to allow opting-out of processing doc comments would certainly be do-able, I'll take a closer look when I get more time

[GREsau]

I'm implementing this now, you'll be able to include an attribute to override any title/description from doc comments like so:

#[derive(JsonSchema)]
pub struct OverrideDocs {

    /// This comment will not be used as the description
    #[schemars(description = "This is the description!")]
    pub my_int: i32,

    /// This field will have no description set
    #[schemars(description = "")]
    pub my_undocumented_bool: bool,
}

[GREsau]

The above change is implemented in v0.7.5

[rw]

Thanks!