[API] Style feedback

[lcawl]

@szabosteve provided feedback from @sophiec20 about some areas for improvement in the API docs:

1. The method for showing and hiding object details. For example:
   
   Can this be an icon or arrow instead of repeated text?

2. Nested properties and parameters. For example:
   
   Can the description be indented or the parameter/property name be bolder or bigger to make it easier to identify?

[szabosteve]

Thank you @lcawl for opening this issue!

the parameter/property name be bolder or bigger

Or even code highlighted to better distinguish property names from descriptions and make it easier to skim the param list.