-
-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Open
Labels
good first issueThis is an issue suited for newcomers to become aquianted with working on the codebase.This is an issue suited for newcomers to become aquianted with working on the codebase.kind:bugA bug in the code. Does not apply to documentation, specs, etc.A bug in the code. Does not apply to documentation, specs, etc.topic:tools:docs-generator
Description
Bug Report
Somewhat related to #14039, the def_clone macro has a comment directly on the method generated by the macro. This makes it so you cannot customize the API docs for the generated method. My use case being wanting to throw a :nodoc: on it.
Easiest solution would be to remove the default comment, but could maybe do something with https://crystal-lang.org/reference/1.15/syntax_and_semantics/macros/index.html#merging-expansion-and-call-comments to only use it if there is not a doc comment on the macro call.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
good first issueThis is an issue suited for newcomers to become aquianted with working on the codebase.This is an issue suited for newcomers to become aquianted with working on the codebase.kind:bugA bug in the code. Does not apply to documentation, specs, etc.A bug in the code. Does not apply to documentation, specs, etc.topic:tools:docs-generator