diff --git a/public/doc-shredder/_test/.gitignore b/tools/doc-shredder/_test/.gitignore
similarity index 100%
rename from public/doc-shredder/_test/.gitignore
rename to tools/doc-shredder/_test/.gitignore
diff --git a/public/doc-shredder/_test/README.md b/tools/doc-shredder/_test/README.md
similarity index 100%
rename from public/doc-shredder/_test/README.md
rename to tools/doc-shredder/_test/README.md
diff --git a/public/doc-shredder/_test/copy.to.ovr.bat b/tools/doc-shredder/_test/copy.to.ovr.bat
similarity index 100%
rename from public/doc-shredder/_test/copy.to.ovr.bat
rename to tools/doc-shredder/_test/copy.to.ovr.bat
diff --git a/public/doc-shredder/_test/doc-shredder.spec.js b/tools/doc-shredder/_test/doc-shredder.spec.js
similarity index 100%
rename from public/doc-shredder/_test/doc-shredder.spec.js
rename to tools/doc-shredder/_test/doc-shredder.spec.js
diff --git a/public/doc-shredder/_test/gulpfile.js b/tools/doc-shredder/_test/gulpfile.js
similarity index 94%
rename from public/doc-shredder/_test/gulpfile.js
rename to tools/doc-shredder/_test/gulpfile.js
index 6bbb77b236..e211786407 100644
--- a/public/doc-shredder/_test/gulpfile.js
+++ b/tools/doc-shredder/_test/gulpfile.js
@@ -37,8 +37,9 @@ gulp.task('watch', function (cb) {
 gulp.task('map', function() {
   var options = {
     jadeDir: 'test_jade',
-    examplesDir: 'test_source',
+    apiExamplesDir: 'test_source',
     fragmentsDir: 'test_fragments',
+    devguideExamplesDir: 'test_source',
     outputDir: '.'
   }
   return docShredder.buildShredMap(options).then(function(x) {
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/main2-bootstrap.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/main2-bootstrap.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/main2-bootstrap.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/main2-bootstrap.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/main2-import.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/main2-import.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/main2-import.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/main2-import.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/main2-twoparts.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/main2-twoparts.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/main2-twoparts.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/main2-twoparts.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/main3-bootstrap.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/main3-bootstrap.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/main3-bootstrap.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/main3-bootstrap.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/main3-import.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/main3-import.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/main3-import.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/main3-import.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/main3-noend.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/main3-noend.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/main3-noend.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/main3-noend.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/main3-noend2.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/main3-noend2.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/main3-noend2.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/main3-noend2.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/main3-twoparts.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/main3-twoparts.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/main3-twoparts.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/main3-twoparts.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/mainBlankDocPlaster-import.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/mainBlankDocPlaster-import.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/mainBlankDocPlaster-import.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/mainBlankDocPlaster-import.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/mainBlankDocPlaster-twoparts.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/mainBlankDocPlaster-twoparts.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/mainBlankDocPlaster-twoparts.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/mainBlankDocPlaster-twoparts.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/pubspec-bar.yaml.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/pubspec-bar.yaml.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/pubspec-bar.yaml.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/pubspec-bar.yaml.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/pubspec-foo.yaml.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/pubspec-foo.yaml.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/pubspec-foo.yaml.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/pubspec-foo.yaml.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/simple-bar.html.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/simple-bar.html.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/simple-bar.html.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/simple-bar.html.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/simple-foo.html.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/simple-foo.html.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/simple-foo.html.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/simple-foo.html.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/style-bar.css.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/style-bar.css.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/style-bar.css.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/style-bar.css.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/multiregion/style-foo.css.ovr.md b/tools/doc-shredder/_test/test_fragments/multiregion/style-foo.css.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/multiregion/style-foo.css.ovr.md
rename to tools/doc-shredder/_test/test_fragments/multiregion/style-foo.css.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/main-bootstrap.js.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/main-bootstrap.js.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/main-bootstrap.js.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/main-bootstrap.js.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/main-bootstrap.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/main-bootstrap.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/main-bootstrap.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/main-bootstrap.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/main-import.js.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/main-import.js.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/main-import.js.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/main-import.js.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/main-import.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/main-import.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/main-import.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/main-import.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/main.js.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/main.js.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/main.js.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/main.js.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/main.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/main.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/main.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/main.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/named-regions-app.html.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/named-regions-app.html.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/named-regions-app.html.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/named-regions-app.html.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/named-regions-script.html.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/named-regions-script.html.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/named-regions-script.html.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/named-regions-script.html.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-all.js.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-all.js.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-all.js.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-all.js.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-bootstrap.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-bootstrap.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-bootstrap.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-bootstrap.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-class-w-annotations.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-class-w-annotations.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-class-w-annotations.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-class-w-annotations.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-class.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-class.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-class.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-class.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-greet.js.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-greet.js.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-greet.js.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-greet.js.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-import.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-import.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-import.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-import.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-log.js.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-log.js.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-log.js.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions-log.js.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions.ts.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions.ts.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/nested-regions.ts.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/nested-regions.ts.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/nestedFolder/script.js.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/nestedFolder/script.js.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/nestedFolder/script.js.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/nestedFolder/script.js.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/pubspec.yaml.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/pubspec.yaml.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/pubspec.yaml.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/pubspec.yaml.ovr.md
diff --git a/public/doc-shredder/_test/test_fragments/no-multiregion/simple.html.ovr.md b/tools/doc-shredder/_test/test_fragments/no-multiregion/simple.html.ovr.md
similarity index 100%
rename from public/doc-shredder/_test/test_fragments/no-multiregion/simple.html.ovr.md
rename to tools/doc-shredder/_test/test_fragments/no-multiregion/simple.html.ovr.md
diff --git a/public/doc-shredder/_test/test_jade/guides/setupAlt2.jade b/tools/doc-shredder/_test/test_jade/guides/setupAlt2.jade
similarity index 100%
rename from public/doc-shredder/_test/test_jade/guides/setupAlt2.jade
rename to tools/doc-shredder/_test/test_jade/guides/setupAlt2.jade
diff --git a/public/doc-shredder/_test/test_jade/setupAlt.jade b/tools/doc-shredder/_test/test_jade/setupAlt.jade
similarity index 99%
rename from public/doc-shredder/_test/test_jade/setupAlt.jade
rename to tools/doc-shredder/_test/test_jade/setupAlt.jade
index 440784bb1b..601ab9cb87 100644
--- a/public/doc-shredder/_test/test_jade/setupAlt.jade
+++ b/tools/doc-shredder/_test/test_jade/setupAlt.jade
@@ -33,11 +33,11 @@ include ../../../../_includes/_util-fns
 
     In the `<body>`, add an element called `<my-app>` that will be the root of your
     application.
-    
+
     The TypeScript setup includes System.js, a third-party open-source library that adds ES6 module loading functionality to browsers. This step isn't needed for the ES5 version.
 
   +makeTabs('gettingstarted', 'ts/index2.html,js/index.html', 'TypeScript, JavaScript')
-  
+
 .callout.is-helpful
   header Don't use code.angularjs.org in a live app
   :markdown
diff --git a/public/doc-shredder/_test/test_source/multiregion/main2.ts b/tools/doc-shredder/_test/test_source/multiregion/main2.ts
similarity index 100%
rename from public/doc-shredder/_test/test_source/multiregion/main2.ts
rename to tools/doc-shredder/_test/test_source/multiregion/main2.ts
diff --git a/public/doc-shredder/_test/test_source/multiregion/main3.ts b/tools/doc-shredder/_test/test_source/multiregion/main3.ts
similarity index 100%
rename from public/doc-shredder/_test/test_source/multiregion/main3.ts
rename to tools/doc-shredder/_test/test_source/multiregion/main3.ts
diff --git a/public/doc-shredder/_test/test_source/multiregion/mainBlankDocPlaster.ts b/tools/doc-shredder/_test/test_source/multiregion/mainBlankDocPlaster.ts
similarity index 100%
rename from public/doc-shredder/_test/test_source/multiregion/mainBlankDocPlaster.ts
rename to tools/doc-shredder/_test/test_source/multiregion/mainBlankDocPlaster.ts
diff --git a/public/doc-shredder/_test/test_source/multiregion/pubspec.yaml b/tools/doc-shredder/_test/test_source/multiregion/pubspec.yaml
similarity index 100%
rename from public/doc-shredder/_test/test_source/multiregion/pubspec.yaml
rename to tools/doc-shredder/_test/test_source/multiregion/pubspec.yaml
diff --git a/public/doc-shredder/_test/test_source/multiregion/simple.html b/tools/doc-shredder/_test/test_source/multiregion/simple.html
similarity index 100%
rename from public/doc-shredder/_test/test_source/multiregion/simple.html
rename to tools/doc-shredder/_test/test_source/multiregion/simple.html
diff --git a/public/doc-shredder/_test/test_source/multiregion/style.css b/tools/doc-shredder/_test/test_source/multiregion/style.css
similarity index 100%
rename from public/doc-shredder/_test/test_source/multiregion/style.css
rename to tools/doc-shredder/_test/test_source/multiregion/style.css
diff --git a/public/doc-shredder/_test/test_source/no-multiregion/do-not-read.js b/tools/doc-shredder/_test/test_source/no-multiregion/do-not-read.js
similarity index 100%
rename from public/doc-shredder/_test/test_source/no-multiregion/do-not-read.js
rename to tools/doc-shredder/_test/test_source/no-multiregion/do-not-read.js
diff --git a/public/doc-shredder/_test/test_source/no-multiregion/main.js b/tools/doc-shredder/_test/test_source/no-multiregion/main.js
similarity index 100%
rename from public/doc-shredder/_test/test_source/no-multiregion/main.js
rename to tools/doc-shredder/_test/test_source/no-multiregion/main.js
diff --git a/public/doc-shredder/_test/test_source/no-multiregion/main.ts b/tools/doc-shredder/_test/test_source/no-multiregion/main.ts
similarity index 100%
rename from public/doc-shredder/_test/test_source/no-multiregion/main.ts
rename to tools/doc-shredder/_test/test_source/no-multiregion/main.ts
diff --git a/public/doc-shredder/_test/test_source/no-multiregion/named-regions.html b/tools/doc-shredder/_test/test_source/no-multiregion/named-regions.html
similarity index 100%
rename from public/doc-shredder/_test/test_source/no-multiregion/named-regions.html
rename to tools/doc-shredder/_test/test_source/no-multiregion/named-regions.html
diff --git a/public/doc-shredder/_test/test_source/no-multiregion/nested-regions.js b/tools/doc-shredder/_test/test_source/no-multiregion/nested-regions.js
similarity index 100%
rename from public/doc-shredder/_test/test_source/no-multiregion/nested-regions.js
rename to tools/doc-shredder/_test/test_source/no-multiregion/nested-regions.js
diff --git a/public/doc-shredder/_test/test_source/no-multiregion/nested-regions.ts b/tools/doc-shredder/_test/test_source/no-multiregion/nested-regions.ts
similarity index 100%
rename from public/doc-shredder/_test/test_source/no-multiregion/nested-regions.ts
rename to tools/doc-shredder/_test/test_source/no-multiregion/nested-regions.ts
diff --git a/public/doc-shredder/_test/test_source/no-multiregion/nestedFolder/script.js b/tools/doc-shredder/_test/test_source/no-multiregion/nestedFolder/script.js
similarity index 100%
rename from public/doc-shredder/_test/test_source/no-multiregion/nestedFolder/script.js
rename to tools/doc-shredder/_test/test_source/no-multiregion/nestedFolder/script.js
diff --git a/public/doc-shredder/_test/test_source/no-multiregion/pubspec.yaml b/tools/doc-shredder/_test/test_source/no-multiregion/pubspec.yaml
similarity index 100%
rename from public/doc-shredder/_test/test_source/no-multiregion/pubspec.yaml
rename to tools/doc-shredder/_test/test_source/no-multiregion/pubspec.yaml
diff --git a/public/doc-shredder/_test/test_source/no-multiregion/simple.html b/tools/doc-shredder/_test/test_source/no-multiregion/simple.html
similarity index 100%
rename from public/doc-shredder/_test/test_source/no-multiregion/simple.html
rename to tools/doc-shredder/_test/test_source/no-multiregion/simple.html
diff --git a/public/doc-shredder/doc-shredder.js b/tools/doc-shredder/doc-shredder.js
similarity index 94%
rename from public/doc-shredder/doc-shredder.js
rename to tools/doc-shredder/doc-shredder.js
index 275f6600cd..128e1a0e1e 100644
--- a/public/doc-shredder/doc-shredder.js
+++ b/tools/doc-shredder/doc-shredder.js
@@ -62,11 +62,11 @@ function createShredPackage(shredOptions) {
   var options = resolveShredOptions(shredOptions);
 
   initializePackage(pkg)
-    .factory(require('./fileShredder'))
-    .processor(require('./mdWrapperProcessor'))
+    .factory(require('./fileReaders/regionFileReader'))
+    .processor(require('./processors/renderAsMarkdownProcessor'))
 
-    .config(function(readFilesProcessor, fileShredder ) {
-      readFilesProcessor.fileReaders = [ fileShredder];
+    .config(function(readFilesProcessor, regionFileReader) {
+      readFilesProcessor.fileReaders = [regionFileReader];
     })
     // default configs - may be overriden
     .config(function(readFilesProcessor) {
@@ -106,8 +106,8 @@ var createShredMapPackage = function(mapOptions) {
   var options = resolveMapOptions(mapOptions);
 
   initializePackage(pkg)
-    .factory(require('./extractPathsReader'))
-    .processor(require('./shredMapProcessor'))
+    .factory(require('./fileReaders/extractPathsReader'))
+    .processor(require('./processors/shredMapProcessor'))
     .config(function(shredMapProcessor) {
       shredMapProcessor.options = options;
     })
@@ -180,11 +180,12 @@ var createShredMapPackage = function(mapOptions) {
 }
 
 function resolveShredOptions(shredOptions) {
+  var DOCS_FOLDER = '../../public/docs';
   var so =  _.defaults({}, shredOptions, {
     // read files from any subdir under here
-    examplesDir: "./docs/_examples",
+    examplesDir: path.join(DOCS_FOLDER, "_examples"),
     // shredded files get copied here with same subdir structure.
-    fragmentsDir: "./docs/_fragments",
+    fragmentsDir: path.join(DOCS_FOLDER, "_fragments"),
     // whether to include subdirectories when shredding.
     includeSubdirs: true
   });
diff --git a/public/doc-shredder/extractPathsReader.js b/tools/doc-shredder/fileReaders/extractPathsReader.js
similarity index 100%
rename from public/doc-shredder/extractPathsReader.js
rename to tools/doc-shredder/fileReaders/extractPathsReader.js
diff --git a/public/doc-shredder/fileShredder.js b/tools/doc-shredder/fileReaders/regionFileReader.js
similarity index 76%
rename from public/doc-shredder/fileShredder.js
rename to tools/doc-shredder/fileReaders/regionFileReader.js
index 4231ef0799..c4a96eaf64 100644
--- a/public/doc-shredder/fileShredder.js
+++ b/tools/doc-shredder/fileReaders/regionFileReader.js
@@ -1,13 +1,13 @@
-var regionExtractor = require('./regionExtractor');
+var regionExtractor = require('../regionExtractor');
 var buildRegionDocs = regionExtractor.buildRegionDocs;
 
 /**
- * @dgService htmlFileShredder
+ * @dgService
  * @description
  */
-module.exports = function fileShredder(log ) {
+module.exports = function regionFileReader(log ) {
   return {
-    name: 'fileShredder',
+    name: 'regionFileReader',
 
     getDocs: function (fileInfo) {
       // log.info("fileShredder processing: " + fileInfo.relativePath);
diff --git a/public/doc-shredder/notes.md b/tools/doc-shredder/notes.md
similarity index 100%
rename from public/doc-shredder/notes.md
rename to tools/doc-shredder/notes.md
diff --git a/public/doc-shredder/mdWrapperProcessor.js b/tools/doc-shredder/processors/renderAsMarkdownProcessor.js
similarity index 88%
rename from public/doc-shredder/mdWrapperProcessor.js
rename to tools/doc-shredder/processors/renderAsMarkdownProcessor.js
index 0eb30d0818..5fb77f5bed 100644
--- a/public/doc-shredder/mdWrapperProcessor.js
+++ b/tools/doc-shredder/processors/renderAsMarkdownProcessor.js
@@ -1,9 +1,9 @@
 /**
- * dgProcessor shredderProcessor
+ * dgProcessor
  * @description
  *
  */
-module.exports = function mdWrapperProcessor(log) {
+module.exports = function renderAsMarkdownProcessor() {
   return {
     $runAfter: ['readFilesProcessor'],
     $runBefore: ['writing-files'],
diff --git a/public/doc-shredder/shredMapProcessor.js b/tools/doc-shredder/processors/shredMapProcessor.js
similarity index 100%
rename from public/doc-shredder/shredMapProcessor.js
rename to tools/doc-shredder/processors/shredMapProcessor.js
diff --git a/public/doc-shredder/regionExtractor.js b/tools/doc-shredder/regionExtractor.js
similarity index 100%
rename from public/doc-shredder/regionExtractor.js
rename to tools/doc-shredder/regionExtractor.js
diff --git a/public/doc-shredder/xref-doc.json.template b/tools/doc-shredder/xref-doc.json.template
similarity index 100%
rename from public/doc-shredder/xref-doc.json.template
rename to tools/doc-shredder/xref-doc.json.template
diff --git a/public/doc-shredder/xref-frag.html.template b/tools/doc-shredder/xref-frag.html.template
similarity index 100%
rename from public/doc-shredder/xref-frag.html.template
rename to tools/doc-shredder/xref-frag.html.template
diff --git a/public/doc-shredder/xref-jade.html.template b/tools/doc-shredder/xref-jade.html.template
similarity index 100%
rename from public/doc-shredder/xref-jade.html.template
rename to tools/doc-shredder/xref-jade.html.template