input.checked not passed even if value is a boolean?

According to the Field docs, checked should be passed as a prop the wrapped component if the value is a boolean:

input.checked : boolean [optional]

An alias for value only when value is a boolean. Provided for convenience of destructuring the > whole field object into the props of a form element.

But, even if the value is a boolean, to me it seems that input.checked is provided only if I specify the prop type="checkbox" on the Field component?

I could be doing something wrong of course. But is it possible that this is a bug or is there something missing the documentation? The documented props you can pass to Field says nothing about type.

I would be glad to contribute if someone points me in the right direction.

[danielrob]

Question here: it seems clear that if type="checkbox" is specified, this works. Are people wishing for the docs to be correct, or wishing for the docs to reflect the current behaviour? Add a thumbs up for not needing to add type="checkbox" and a thumbs down for the docs stating you need to add type="checkbox"

Related: #2292

[aij]

@danielrob How is one supposed to use type="checkbox" with <Fields />? (plural)

I don’t care whether the documentation is changed to match the code, or the code is changed to match the documentation. I can see arguments going either way, but having them disagree is worse than either option.