update docs and deleted outdated build docs

Author: thescientist13

packages/cli/src/lib/resource-interface.js

@@ -9,7 +9,7 @@ class ResourceInterface {
   }
 
   // test if this plugin should change a relative URL from the browser to an absolute path on disk 
-  // like for node_modules/ resolution, not commonly needed
+  // like for node_modules/ resolution. not commonly needed by most resource plugins
   // return true | false
   // eslint-disable-next-line no-unused-vars
   async shouldResolve(url) {
@@ -29,14 +29,14 @@ class ResourceInterface {
     return Promise.resolve(this.extensions.indexOf(path.extname(url)) >= 0);
   }
 
-  // return the new body and / or contentType, e.g. convert file.foo -> .js
+  // return the new body and / or contentType, e.g. convert file.foo -> file.js
   // eslint-disable-next-line no-unused-vars
   async serve(url, headers) {
     return Promise.resolve({});
   }
 
   // test if this plugin should return a new body for an already resolved resource
-  // useful for modifying code on the fly without needing to touch the file
+  // useful for modifying code on the fly without needing to read the file from disk
   // return true | false
   // eslint-disable-next-line no-unused-vars
   async shouldIntercept(url, body, headers) {
@@ -50,7 +50,7 @@ class ResourceInterface {
   }
 
   // test if this plugin should manipulate any files prior to any final optmizations happening 
-  // ex: add a "banner" to all .js files with a timestamp of the build
+  // ex: add a "banner" to all .js files with a timestamp of the build, or minifying files
   // return true | false
   // eslint-disable-next-line no-unused-vars
   async shouldOptimize(url, body) {

www/pages/docs/build.md

@@ -2,7 +2,7 @@
 label: 'styles-assets'
 menu: side
 title: 'Styles and Assets'
-index: 6
+index: 5
 linkheadings: 3
 ---
 

www/pages/docs/css-and-images.md

@@ -2,7 +2,7 @@
 label: 'front-matter'
 menu: side
 title: 'Front Matter'
-index: 4
+index: 3
 linkheadings: 3
 ---
 

www/pages/docs/front-matter.md

@@ -2,7 +2,7 @@
 label: 'markdown'
 menu: side
 title: 'Markdown'
-index: 5
+index: 4
 linkheadings: 3
 ---
 

www/pages/docs/markdown.md

@@ -14,6 +14,8 @@ The available plugins built and maintained by Greenwood team and contibutors hav
 |---|---|
 | [Google Analytics](https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-google-analytics) | Easily add usage tracking to your site with Google Analytics. |
 | [Import CommonJs](https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-import-commonjs) | Enables usage of `import` syntax for loading CommonJS modules from _node_modules_. |
+| [Import CSS](https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-import-css) | Enables usage of `import` syntax for loading CSS files. |
 | [Polyfills](https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-polyfills) | Although most modern browsers now support the APIs that make up Web Component, for older browsers use this plugin to Let Greenwood automatically take care of progressively loading polyfills for you. |
+| [PostCSS](https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-postcss) | Allows usage of [**PostCSS**](https://postcss.org/) plugins and configuration in your project. |
 
 > See something missing?  Please review our [open issues](https://github.com/ProjectEvergreen/greenwood/issues), we might be [working on it](https://github.com/ProjectEvergreen/greenwood/projects)!  Or if not, please request it, we would be interested to learn how you need to use Greenwod and how the team can help!

www/pages/plugins/custom-plugins.md

@@ -24,7 +24,7 @@ Greenwood aims to cater to these use cases through two approaches:
 ### API
 Each plugin must return a function that has the following three properties:.
 - `name`: A string to give your plugin a name and used for error handling and troubleshooting.
-- `type`: A string to specify to Greenwood the type of plugin.  Right now the current supported plugin type [`'resource'`](/plugins/resource/) and [`'plugin'`](/plugins/server/).
+- `type`: A string to specify to Greenwood the type of plugin.  Right now the current supported plugin types are [`'resource'`](/plugins/resource/), [`'rollup'`](/plugins/rollup/), and [`'server'`](/plugins/server/).
 - `provider`: A function that will be invoked by Greenwood that Can accept  a `compilation` param that provides read-only access to parts of Greenwood's state and configuration that can be used by a plugin.
 
 Here is an example of creating a plugin in a _greenwood.config.js_.

www/pages/plugins/index.md

@@ -20,16 +20,17 @@ Although JavaScript is loosely typed, a [resource "interface"](https://github.co
 const fs = require('fs');
 const { ResourceInterface } = require('@greenwood/cli/src/lib/resource-interface');
 
-class ExampleResource extends ResourceInterface {
-  constructor(compilation, options) {
-    super(compilation, options);
-    this.extensions = ['.foo'];
-    this.contentType = 'text/javascript';
+class ResourceInterface {
+  constructor(compilation, options = {}) {
+    this.compilation = compilation;
+    this.options = options;
+    this.extensions = [];
+    this.contentType = '';
   }
 
-  // test if this plugin should change a relative URL from the browser to an absolute path on disk (like for node_modules/)
+  // test if this plugin should change a relative URL from the browser to an absolute path on disk 
+  // like for node_modules/ resolution. not commonly needed by most resource plugins
   // return true | false
-  // eslint-disable-next-line no-unused-vars
   async shouldResolve(url) {
     return Promise.resolve(false);
   }
@@ -39,32 +40,32 @@ class ExampleResource extends ResourceInterface {
     return Promise.resolve(url);
   }
 
-  // test if this plugin should be used to process a given url / header combo the browser and retu
+  // test if this plugin should be used to process a given url / header for the browser
   // ex: `<script type="module" src="index.ts">`
   // return true | false
   async shouldServe(url, headers) {
     return Promise.resolve(this.extensions.indexOf(path.extname(url)) >= 0);
   }
 
-  // return the new body and / or contentType, e.g. convert file.foo -> .js
+  // return the new body and / or contentType, e.g. convert file.foo -> file.js
   async serve(url, headers) {
     return Promise.resolve({});
   }
 
   // test if this plugin should return a new body for an already resolved resource
-  // useful for modifying code on the fly without needing to touch the file
+  // useful for modifying code on the fly without needing to read the file from disk
   // return true | false
   async shouldIntercept(url, body, headers) {
     return Promise.resolve(false);
   }
 
   // return the new body
   async intercept(url, body, headers) {
-    return Promise.resolve(body);
+    return Promise.resolve({ body });
   }
 
   // test if this plugin should manipulate any files prior to any final optmizations happening 
-  // ex: add a "banner" to all .js files with a timestamp of the build
+  // ex: add a "banner" to all .js files with a timestamp of the build, or minifying files
   // return true | false
   async shouldOptimize(url, body) {
     return Promise.resolve(false);

www/pages/plugins/resource.md

@@ -0,0 +1,32 @@
+---
+label: 'Rollup'
+menu: side
+title: 'Rollup'
+index: 3
+---
+
+## Rollup
+
+These plugins allow users to tap into the [Rollup](https://rollupjs.org/) configuration that Greenwood uses to build and optimize the static assets (JS / CSS) of your site when running the `build` command.  Simply use the `provider` method to return an array of rollup plugins.  Easy!
+
+### Example
+Install your favorite rollup plugin(s), then create a simple object to provde those plugins.
+
+```javascript
+const bannerRollup = require('rollup-plugin-banner');
+const packageJson = require('./package.json'); 
+
+module.exports = (options = {}) => {
+  const now = new Date().now();
+
+  return [{
+    type: 'rollup',
+    name: 'plugin-something-something',
+    provider: () => [
+      banner(`/* ${packageJson.name} v${packageJson.version} - built at ${now}. */`)
+    ]
+  }];
+};
+```
+
+> _You can click to see an [example of a rollup plugin](https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-import-css), which requires a rollup plugin as part of enabling `import` syntax for CSS files._