need way to link example code from apidocs

[jmesserly]

for example, see:
http://api.dartlang.org/docs/bleeding_edge/intl.html

"There is also a simple example application that can be found in the example/basic directory."

As a new user, that doesn't help :)

I happen to know that I can find this file on my hard drive at $DART_SDK/pkg/intl/example/basic, but I don't think most people would know this. If you just get the editor, you might not even realize you have dart-sdk under it's install directory.

What should doc authors do here? The example might be too big to just inline it. This is common in web_ui, where the example sometimes spans multiple files. Perhaps we could have a way to embed larger examples. I really like how http://angularjs.org/ does it on their home page, for example.

[DartBot]

This comment was originally written by amouravski@google.com

---

Added Duplicate label.
Marked as being merged into #7011.