https://tsdoc.org/ is a good way to document the use of each argument/prop in a function/component, and those comments will appear when typing a function call in an editor that supports IntelliSense (such as VS Code).
We could add general descriptions of each prop, but we can also use that as a place for recommendations/warnings about the use of certain props (see #112 for an example).