On https://www.rubydoc.info/gems/yard/file/docs/Tags.md#attr, the docs for @attr are:

 @attr name [Types] description 

However the example given is:

# @attr [String] name the name of the structure

The name and the types are inverted.

Next step in docs check: not only correction, but also quality.

Some ideas on checks:

• simple "undocumented X" for X in (class, method, constant, parameter, what else?);
• unnecessary documented return value for predicate methods (YARD does it automatically);
• wrongful documented return value type for predicate methods (when it is documented and is not boolean);
• possibly undocumented op

Add basic validation for method's parameters. If they're invalid then don't document either entire method or only skip its parameters.

Bad params examples:

def foo(bar, baz qux)
end

def foo ; end