Package docs content into an npm package

[jelbourn]

We currently publish the docs content to https://github.com/angular/material2-docs-content in an ad hoc structure. It's not an npm package, meaning we need a bash script to pull in the content to the right place.

Things that are pending:

• Build material-examples using Bazel
• Generate highlighted files from example source w/ Bazel
• Docs SCSS should no longer expect a class for each markdown HTML element
• Package all together in a NPM package:
  • Example package (needed for show-casing examples in the docs)
  • StackBlitz example source files (needed for external stackblitz examples)
  • Highlighted example source files (in .html, needed for source view of examples)
  • Guides which will be shown in the docs
  • Components overview files

[devversion]

I think we discussed just having another Github builds repository for that, right? Pushing it to NPM might cause confusion since it's technically just our internal "package".

[jelbourn]

Is there any reason not to reuse the existing repo?

[devversion]

I was just thinking that we need another repository because one would be for the @angular/material-examples package and the other one just for the individual API/guide/StackBlitz files.

dependencies: {
  "@angular/material-examples": "github:angular/material2-docs-content"
}

After re-reading, I think you've actually meant that we should somehow package the API, guide and StackBlitz files into the same NPM package. That way we would eliminate all scripts, right?

[jelbourn]

Yep, exactly