I think this would be fine, but I this would need to be an issue first to gain approvals from the others. @nrmancuso is already trying to rewrite other parts of our documentation, so I want to sure we align with his current thoughts.

I think @rnveach is on board with the proposal....
@nrmancuso , @romani , thoughts please ?

I like tables, @romani please approve if you are good. I would prefer just “Option” and “Description”

Yes, let's try table view.
Please make first column (or just embed in name of parameter) to be anchor, let us make direct links to specific argument.

Example:
https://checkstyle.org/google_style.html#a2

Google style has links to itself, to specific row.
When you click on anchor image, you got a link and you can share it with others, it will be a link to exact place, not a page in general

consider https://checkstyle.org/property_types.html#Pattern.5B.5D as example, move mouse over title, anchor appears and by click you can get a link exactly to this item in huge whole page

Yes @romani , your #14759 (comment) was clear enough for me 😄

consider https://checkstyle.org/property_types.html#Pattern.5B.5D as example,

I get what you want me to do here,
but I don't see anchored links in the example you gave? Do you want that page also updated?

Send PR, I will point what to do in PR