Rules don't generate documentation for the "common" attributes (but macros do?)

[thomasvl]

The generated documentation for a "rule" doesn't include all of the common rule attributes, example - https://github.com/bazelbuild/stardoc/blob/master/test/testdata/attribute_types_test/golden.md

But generated documentation for a "macro" can if it uses inherit_attrs = "common", (example - https://github.com/bazelbuild/stardoc/blob/master/test/testdata/symbolic_macro_inherit_attrs_test/bazel_8_golden.md#inherit_from_common) or it uses inherit_attrs = some_rule_reference,
(example - https://github.com/bazelbuild/stardoc/blob/master/test/testdata/symbolic_macro_inherit_attrs_test/bazel_8_golden.md#inherit_from_rule)

In that second case, the generated docs for some_rule_reference won't include those attributes, but the macro will. Shouldn't the "rule" also be generating those or have a way to? i.e. - what do "macro" docs have this extra info, but the "rule" docs don't?

[tetromino]

You are correct. Would be good to do. We had not done it until now because until Bazel commit 1ce4ab15fab18063d8291132ea84e71fa02d27c4 we could only extract Starlark-defined attributes - but now it's possible.

Note that before any Stardoc changes, we'd need to change starlark_doc_extract proto output in Bazel.