Documentation of parameters is ugly and inconsistent

[gibson042]

Originally posted by @erights in #876 (comment)

`farName` `{ String }`

What are these curly brackets about? If the intention is to mirror ts-in-jsdoc notation, the parameter name would come after the type, which I agree is unpleasant. How about we use ts notation for types in the docs:

`farName: string`

[dckc]

here's hoping to sync with typedoc, but @endo/marshal typedoc seems to be a stub so far.