Ability to suppress macro documentation warnings

[c-parsons]

See bazelbuild/bazel#7977 (comment)

We would suggest that users set default values for rules via a wrapper macro. Wrapper macros become more annoying to write, though, if they need to mirror the full documentation of their rule.

We might consider using a meta tag to note that a macro should inherit (or link to) the documentation for the rule it wraps, and this should suppress buildifier warnings.

[laurentlb]

This should already work: https://github.com/bazelbuild/buildtools/blob/master/WARNINGS.md#how-to-disable-this-warning

[c-parsons]

So suppression with

# buildozer: disable=function-docstring

should work to suppress the docstring error?
Probably a good enough workaround for now.
I'm not sure suppressing warnings is a good permanent solution, given that we are recommending macro-wrapping-rule as a common pattern.

[aiuto]

Also see #768