I wonder why there is no such an alias, which would conveniently follow function definition of Solidity itself. Of course, it’s mostly aesthetics, though it would look a bit nicer to be able to put “@returns” just like in the code of the contract itself.
I don’t see any major issue with that idea, except maybe that often you don’t want to provide multiple ways to do the same thing.
You can always suggest it in a ticket in our github repository of course 