Support for decorated functions

[a-delannoy]

Summary

It could make sense to somehow introduce in the generated documentation information about the possible decorators on top of the documented functions (and classes maybe).

Example

For example, common decorators, like @overload or @property, are invisible in the generated documentation. A function decorated with those would just appear several times in the doc, with no hint about it.

Your opinion on this ?

Since it is a common pattern in python to use decorators, introducing an annotation about it might help ease the navigate through the generated documentation.

Do you think it could make sense to improve the lib towards that direction ?

[zzstoatzz]

hi @a-delannoy - thanks for the issue and sorry for the delayed response, i've been on vacation for a bit.

im open to reviewing a PR that would make an attempt at this! i'd be open to it as long as it wasn't too distracting