show available prebuilt themes in docs

[manuel-mauky]

Bug, feature request, or proposal:

feature request documentation

What is the expected behavior?

In the docs users should see a list of available prebuilt themes and a link to a sample page of each theme.

What is the current behavior?

No information of what themes are available and how they look like.

What are the steps to reproduce?

Providing a Plunker (or similar) is the best way to get the team to see your issue.
Plunker template: https://goo.gl/DlHd6U

What is the use-case or motivation for changing an existing behavior?

I like to use this great library but the documentation could be improved to make the start easier.

Which versions of Angular, Material, OS, browsers are affected?

Is there anything else we should know?

[M-a-c]

@jelbourn
Issue question:
Where should these examples be created?
/src/examples/theme-NameofTheme-overview ?
Just one and then reference the other defaults, or all 4 themes?

Extra question:
Also are there going to be more default themes? / a theme builder ?

[jelbourn]

We should list all of the prebuilt themes in the theming guide.

We will add more prebuilt themes before final.

We do want to add a theme builder to the docs site eventually, but that's more of a nice-to-have.

[devversion]

@M-a-c Are you looking into this?

[M-a-c]

Yeah I was going to tackle it Monday if thats ok. I don't have a pr for it right now.
I think this 'show available prebuilt themes in docs' should be re-added, for when there are more themes, before going gold.

[devversion]

Sounds good! Thanks.

[M-a-c]

Is sample link to each theme necessary ?

If its possible can someone open a P4 on the 'theme builder' and describe how it would work? I would love to work on something like that.

[devversion]

I think for now we only want to list all prebuilt theme paths in the theming guide.

We could do that with a Dgeni processor or just with gulp transform.

[M-a-c]

Reading up on Dgeni and gulp now, sorry for the confusion. I had no idea this existed. I was wondering how exactly this sorta magic happened. I'll dig for an example to figure this out.

[jelbourn]

I'm not sure this is something that needs to be done with tooling; the prebuilt themes will change infrequently enough that i'm okay with just manually listing them in the guide.

[M-a-c]

@devversion @jelbourn I'm a bit confused with who to follow, I'm pretty sure I'm more than half way done tooling a solution. Is it ok if I continue on that?

[devversion]

Please do what @jelbourn proposed.

I initially thought that a dynamic solution would be appropriated but since we don't have frequent changes with the prebuilt-themes I can kind of see Jeremy's point. Sorry for the misunderstanding.