(feat) Support for importing example partials

[btesser]

The ngdocs syntax is excellent, but I have a strong aversion to putting html and javascript examples directly in the code. Is it possible with dgeni to maybe write an adapter that would allow importing external html partials and js files for examples? Possible syntax would be:

/**
 * @example.html url('../examples/feature/dosomething.html')
 * @example.js url('../examples/feature/dosomething.js')
 */

[petebacondarwin]

Great idea. I think it would work better with an inline tag, perhaps...

{@example srcs="['examples/feature/dosomething.html', ...]"}

... then you can place examples at any point in your documentation.

[btesser]

No arguments. Feature is the main thing!

[boennemann]

I love the idea :+1:

[petebacondarwin]

Anyone fancy writing a pull request to dgeni-packages for this?