md-dialog and md-dialog-content are not documented

[djmarcus1]

The Angular/Material DIRECTIVES sidebar does not show these directives at all.

This is a complex subject that really should have detailed API and a few decent demo examples.

Perhaps someone who is not a newbie (as I am) to Angular/Material could correct this in the next release.

[ThomasBurleson]

This is what we have currently: https://material.angularjs.org/HEAD/#/api/material.components.dialog/service/$mdDialog.
Your feedback is useful, however, in that it highlights a confusion point where developers may only search the Directives sublist.

[djmarcus1]

I had already seen the page (https://material.angularjs.org/HEAD/#/api/material.components.dialog/service/$mdDialog).

In fact, it helped me enough to get me going, but honestly dialogs are a big part of modern user interaction... and they can get fairly complex. Therefore, they should, at the very least, include a formal demo link from that page, and there needs to be a whole discussion with cookbook samples to illustrate how to do top-notch dialogs. I learn fastest by seeing examples. All the progress on my dialogs that I have made have come from seeing CodePen examples.

Don't misunderstand my feedback. I am incredibly impressed with Angular/Materials... its amazing and the best framework I've seen on top of Angular. Yet, the key for its widest adoption is to reduce the learning curve. This can only be achieved by having great documentation and copious examples.

:-)

[ThomasBurleson]

The Angular Material Core team completely agrees. Unfortunately, we are focused with 100% capacity on the upcoming v1.0 release: stabilization, polish, and performance are the main focus areas.
Would you be interested in helping with the Dialog docs?

[djmarcus1]

For sure.
Is there any information on how to update the docs (and the website pages)?

You can reach me directly at my email of djmarcus with the domain name of m5inc with top level of com.

-David

[ThomasBurleson]

@Splaktar - Do you have time to help ramp @djmarcus1 upon the fork-branch-update-pullrequest process ?

[Splaktar]

Yep, I will contact him in an hour or two.

[Splaktar]

Email and Hangouts request sent to @djmarcus1.

In the mean time, please take a look at https://github.com/angular/material/blob/master/docs/guides/CONTRIBUTING.md

[Splaktar]

Spoke to him last night and made a lot of progress getting him up and running.