Florent Bécart

I will simply use the `title` and `description` attributes for now: https://github.com/GREsau/schemars/blob/f9b14f7b00edcb4248c2243ddee9e116b798fa70/docs/1.1-attributes.md#schemarstitle--some-title-description--some-description

@untitaker I understand that this solution is enough to improve support for comments that are heavy in code blocks. But this toggle wouldn't solve my use case. Indeed, my documentation...

> could you explain how the schema ends up in vscode? Sure. The URL to Zinoma's schema is declared in SchemaStore: https://github.com/SchemaStore/schemastore/pull/1068/files IDEs (VSCode, IntelliJ...) automatically pull the list of...

> Main issue I have is that the docs are losing a lot of information if all the markdown is ripped out. That makes a lot of sense. Now I...

I'm not in the position to make a design decision, as I have a very limited knowledge of the codebase and the vision of the maintainer. As far as I...

I thought for a while of going that way (see https://github.com/GREsau/schemars/issues/38#issuecomment-640402721), but this represents a lot of comment duplication, which I figured would be particularly hard to maintain. A price...

> I think your interpretation is overly strict. In particular, OpenAPI explicitly allows CommonMark in a schema's description. @GREsau I believe you're right. Thanks for the solution you provided. I...

Hi @robitwtms, I won't be able to help you on this topic, which could be quite specific to your environment. Given the pace at which this space has been evolving...

Thanks @weiznich for the swift reply. I was able to reproduce the issue on the master branch. I had to update my main.rs slightly: ```rust use diesel::{pg::PgConnection, prelude::*}; use diesel_migrations::EmbeddedMigrations;...

The issue shows up here: https://github.com/diesel-rs/diesel/blob/master/diesel_migrations/migrations_internals/src/lib.rs#L89 cargo doesn't have the same level of integration with `read_dir` as it has with `include_str!` for instance.