psl: Can not get documentation from model when these is a empty line. about prisma-engines HOT 5 OPEN

I think this is consistent with pretty much any doc-comment systems out there? Putting empty line after a comment would detach it from the thing it used to document in JavaDoc, JSDoc/TSDoc, rust doc comments, as far as I am aware.

from prisma-engines.

That sounds dangerous. If I just want to take a note in the middle of the file, when using a /// it would then get attached magically to the next block/model instead of just floating, wouldn't it? What is the benefit of this behavior?

Okay, you convinced me.

from prisma-engines.

when there is an empty line between the comment and model, can not get documentation i wan to know why do not process empty line. THX https://github.com/prisma/prisma-engines/blob/main/psl/schema-ast/src/parser/parse_schema.rs#L54
maybe this is better?

from prisma-engines.

I think this is consistent with pretty much any doc-comment systems out there? Putting empty line after a comment would detach it from the thing it used to document in JavaDoc, JSDoc/TSDoc, rust doc comments, as far as I am aware.

it seems that rust doc comments will work when there is space line

/// commnet A

pub struct A {}

from prisma-engines.

That sounds dangerous. If I just want to take a note in the middle of the file, when using a /// it would then get attached magically to the next block/model instead of just floating, wouldn't it? What is the benefit of this behavior?

from prisma-engines.