Update/improve docs for stub macros #27
Description
See https://clojurians.slack.com/archives/C2L9MU2RY/p1646406569961329
The stub macros are provided to aid tools like clj-kondo but their docstrings say do not refer them which kind of defeats their own purpose.