You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Currently, slash command docstrings are consumed by Poise's slash command macro to be used for Discord helper text content. While this is expected behavior, it prevents packages from using that same info from being consumed by cargo doc to generate documentation for commands built with the slash command macro.
It would be fantastic to have the option to have some delineation between the two types of comments to allow cargo doc to generate documentation as usual or in a slightly adjusted way.
TL;DR: It would be nice to be able to use docstrings for both help information in Discord and for cargo doc outputs somehow.
The text was updated successfully, but these errors were encountered:
saint-justin
changed the title
Add an optional way to prevent Docstring consumption
Add an optional way to prevent docstring consumption
Jan 4, 2024
Currently, slash command docstrings are consumed by Poise's slash command macro to be used for Discord helper text content. While this is expected behavior, it prevents packages from using that same info from being consumed by
cargo doc
to generate documentation for commands built with the slash command macro.It would be fantastic to have the option to have some delineation between the two types of comments to allow
cargo doc
to generate documentation as usual or in a slightly adjusted way.TL;DR: It would be nice to be able to use docstrings for both help information in Discord and for
cargo doc
outputs somehow.The text was updated successfully, but these errors were encountered: