chore(docs): adds types column and null checks for description

[amcdnl]

This PR:

• Adds type column for properties
• Adds null check to descriptions

[jelbourn]

Could you include a screenshot of how this looks? How does it fit on mobile?

[amcdnl]

Here is a before/after

[jelbourn]

I'm not a huge fan of how much horizontal space it takes up now; any ideas around how we can keep the name and the type in the same vertical space next to the description?

[willshowell]

From angular/material.angular.io#287 (comment), would you consider moving the type to the description cell and making it distinct via font weight and padding? Just instead of "Return Value:", have it sat "Type:"

[jelbourn]

That could work- I do want to try emphasizing the type by using a monospace font with a different color rather than writing out type to see how that comes across

[amcdnl]

Here is the updated look:

It requires: angular/material.angular.io#292

[jelbourn]

I'm not a huge fan of having "Type: " explicitly. Repeated text like this creates a lot of visual noise

[amcdnl]

Gotcha. Should I just remove type and leave it like is otherwise.

[jelbourn]

Can you post a SS of what that looks like?

[amcdnl]

I'm not sure I like this:

[jelbourn]

What if we add it line with the name, TypeScript syntax style?

@Input()
disabled: boolean

[amcdnl]

@jelbourn - That doesn't look bad ->

[jelbourn]

I do like that more

[jelbourn]

LGTM

[jelbourn]

@amcdnl can you re-create this PR? It was merged before final changes could be made

[amcdnl]

Done in #8125

[angular-automatic-lock-bot]

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}