docs(material/core): Add a brief overview that refers users to the API docs

[mmalerba]

This will allow us to publish a section on the docs site for @angular/material/core.

Related to #8790

[devversion]

We have an exception for the ripples. I assume we want to keep that so that we can continue displaying it as a dedicated entry in the docs site?

One thing to acknowledge is that the ripple API would now also show up in the core entry. Though this might not be a problem.. just raising it here for awareness/discussion.

[mmalerba]

We currently generate API docs for @angular/material/core but don't link to them anywhere. My plan was to create this overview doc just to have something to put in the overview tab so I can create an entry in the docs site for @angular/material/core. Here's what that would look like: https://material2-docs-dev.web.app/components/core/api, it doesn't seem to include the ripple docs, I guess those are extracted.

It's far from an ideal solution, but I think its better to show this information in a non-ideal format than just not show it at all. We can do future passes to organize it better

[devversion]

Here's what that would look like: https://material2-docs-dev.web.app/components/core/api, it doesn't seem to include the ripple docs, I guess those are extracted

Aha! you're right. looks line we're good here. Our Dgeni entry point grouper doesn't add the ripple exports to the core entry-point group, so that they only end up in the ripple group.

And yeah, agreed. Showing the core API docs sounds great to me (especially as a first step)

[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.}