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.