diff --git a/Gemfile b/Gemfile
index e6a4155..1822178 100644
--- a/Gemfile
+++ b/Gemfile
@@ -2,7 +2,3 @@ source 'https://rubygems.org'
 #gem 'github-pages'
 
 gem 'jekyll', '~> 2.5.3'
-
-group :jekyll_plugins do
-  gem 'algoliasearch-jekyll', '~> 0.5.3'
-end
\ No newline at end of file
diff --git a/_config.yml b/_config.yml
index 4a3aeb0..a0001b8 100644
--- a/_config.yml
+++ b/_config.yml
@@ -24,6 +24,8 @@ pdf_file_name: mydoc_designers_pdf.pdf
 gems:
   - algoliasearch-jekyll
 
+# the algolia entries here are experimental only.
+
 algolia:
   application_id: 'HXUBJERYYB'
   index_name:     'documentation_theme_jekyll_designers'
@@ -39,12 +41,7 @@ exclude:
 host: 127.0.0.1
 feedback_email: tomjohnson1492@gmail.com
 
-markdown: redcarpet
-
-redcarpet:
-  extensions: ["no_intra_emphasis", "fenced_code_blocks", "tables", "with_toc_data"]
-
-highlighter: pygments
+highlighter: rouge
 
 collections:
   tooltips:
diff --git a/_includes/search.html b/_includes/algolia.html
similarity index 95%
rename from _includes/search.html
rename to _includes/algolia.html
index aef125b..f19a2d5 100644
--- a/_includes/search.html
+++ b/_includes/algolia.html
@@ -1,3 +1,5 @@
+<!--  this is an experimental of algolia search -->
+
 <div class="search">
 
     <input type="text" placeholder="search...">
diff --git a/_includes/topnav.html b/_includes/topnav.html
index f74c7e2..7346727 100644
--- a/_includes/topnav.html
+++ b/_includes/topnav.html
@@ -71,26 +71,26 @@
                 {% include feedback.html %}
 
 
-                <!--<li>-->
+                <li>
                      <!--start search-->
-                    <!--<div id="search-demo-container">-->
-                        <!--<input type="text" id="search-input" placeholder="{{site.data.strings.search_placeholder_text}}">-->
-                        <!--<ul id="results-container"></ul>-->
-                    <!--</div>-->
-                    <!--<script src="../js/jekyll-search.js" type="text/javascript"></script>-->
-                    <!--<script type="text/javascript">-->
-                        <!--SimpleJekyllSearch.init({-->
-                            <!--searchInput: document.getElementById('search-input'),-->
-                            <!--resultsContainer: document.getElementById('results-container'),-->
-                            <!--dataSource: '../search.json',-->
-                            <!--searchResultTemplate: '<li><a href="{url}" title="{{page.title | replace: "'", "\"}}">{title}</a></li>',-->
-                        <!--noResultsText: '{{site.data.strings.search_no_results_text}}',-->
-                                <!--limit: 10,-->
-                                <!--fuzzy: true,-->
-                        <!--})-->
-                    <!--</script>-->
+                    <div id="search-demo-container">
+                        <input type="text" id="search-input" placeholder="{{site.data.strings.search_placeholder_text}}">
+                        <ul id="results-container"></ul>
+                    </div>
+                    <script src="../js/jekyll-search.js" type="text/javascript"></script>
+                    <script type="text/javascript">
+                        SimpleJekyllSearch.init({
+                            searchInput: document.getElementById('search-input'),
+                            resultsContainer: document.getElementById('results-container'),
+                            dataSource: '../search.json',
+                            searchResultTemplate: '<li><a href="{url}" title="{{page.title | replace: "'", "\"}}">{title}</a></li>',
+                        noResultsText: '{{site.data.strings.search_no_results_text}}',
+                                limit: 10,
+                                fuzzy: true,
+                        })
+                    </script>
                      <!--end search-->
-                <!--</li>-->
+                </li>
             {% comment %}
                 {% include frameescape.html %}
                 {% endcomment %}
diff --git a/_layouts/default.html b/_layouts/default.html
index 64652be..6d50968 100644
--- a/_layouts/default.html
+++ b/_layouts/default.html
@@ -39,7 +39,7 @@
 
             <!-- Content Column -->
             <div class="col-md-9">
-                <!--{% include search.html %}-->
+                <!--{% include algolia.html %}-->
                 {{content}}
             </div><!-- /.row -->
 
diff --git a/_layouts/page.html b/_layouts/page.html
index f3b9b28..8e43e87 100644
--- a/_layouts/page.html
+++ b/_layouts/page.html
@@ -15,9 +15,8 @@ layout: default
 
     {% if site.github_editme_path %}
 
-    <a target="_blank" href="https://github.com/{{site.github_editme_path}}{{page.url | replace: '.html', '.md'}}" class="btn btn-default githubEditButton" role="button"><i class="fa fa-github fa-lg"></i> Edit me</a>
+    <a target="_blank" href="https://github.com/{{site.github_editme_path}}{% unless page.url contains "html" %}{{page.url | replace: '.html', '.md'}}{% endunless %}{% if page.url contains "html" %}{{page.url }}{% endif %}" class="btn btn-default githubEditButton" role="button"><i class="fa fa-github fa-lg"></i> Edit me</a>
     {% endif %}
-
   {{content}}
 
 <div class="tags">
diff --git a/_layouts/page_search.html b/_layouts/page_search.html
index 9d3ecb9..2b5db54 100644
--- a/_layouts/page_search.html
+++ b/_layouts/page_search.html
@@ -8,7 +8,7 @@ layout: default
 
 <div class="post-content">
 
-{% include search.html %}
+{% include algolia.html %}
 
 
 </div>
diff --git a/configs/mydoc/config_designers.yml b/configs/mydoc/config_designers.yml
index 158bf5b..612158e 100644
--- a/configs/mydoc/config_designers.yml
+++ b/configs/mydoc/config_designers.yml
@@ -12,7 +12,7 @@ site_title: Jekyll theme for designers
 project_folder: mydoc
 company_name: Your company
 footer_image_location: ../common_images/company_logo.png
-github_editme_path: tomjohnson1492/documentation-theme-jekyll/edit/reviews
+github_editme_path: tomjohnson1492/documentation-theme-jekyll/edit/docreviews
 disqus_shortname: idrbwjekyll
 # variables
 
diff --git a/configs/mydoc/config_writers.yml b/configs/mydoc/config_writers.yml
index c757408..5789f50 100644
--- a/configs/mydoc/config_writers.yml
+++ b/configs/mydoc/config_writers.yml
@@ -12,7 +12,7 @@ site_title: Jekyll theme for writers
 project_folder: mydoc
 company_name: Your company
 footer_image_location: ../common_images/company_logo.png
-github_editme_path: tomjohnson1492/documentation-theme-jekyll/edit/reviews
+github_editme_path: tomjohnson1492/documentation-theme-jekyll/edit/docreviews
 disqus_shortname: idrbwjekyll
 # variables
 
diff --git a/mydoc/mydoc_adding_new_projects.md b/mydoc/mydoc_adding_new_projects.md
index 5c36304..1a71549 100644
--- a/mydoc/mydoc_adding_new_projects.md
+++ b/mydoc/mydoc_adding_new_projects.md
@@ -7,7 +7,6 @@ summary: "You add a new project essentially by duplicating all the mydoc project
 series: "Getting Started"
 weight: 2
 ---
-<!-- your frontmatter goes here -->
 
 {% include custom/mydoc/getting_started_series.html %}
 
@@ -34,13 +33,15 @@ In the configs folder, copy the mydoc folder and its contents. Rename it to acme
 
 In this theme, each output requires a separate config file. If you have 10 audiences and you want separate sites for each, then then you'll have 10 config files in this directory. 
 
+Change the file names from config_writers.yml and so forth to whatever file names best represent the audiences for your outputs.
+
 More details about customizing the settings in the configuration files will be explained later. For now you're just duplicating the necessary project files for your new project.
 
-### 3. Create a new folder inside \_includes
+### 3. Create a new folder inside \_includes/custom
 
 In the _includes/custom directory, add a new folder there called "acme." This folder should sit parallel to the mydoc folder. This is where you can store includes for your project. 
 
-### 4. Add an acme folder in the root directory
+### 4. Add a new folder in the root directory
 
 In the root directory, add a folder for your pages called acme (similar to the mydoc folder). Include two subfolders inside acme: files and images.
 
@@ -52,7 +53,7 @@ Note that you cannot create subfolders in this acme directory. All of your pages
 
 ### 5. Copy and customize the mydoc shell scripts in the root directory
 
-In the root directory, duplicate the shell scripts and rename the prefix to "acme_". The following files are the shell scripts that need to be duplicated:
+In the root directory, duplicate the shell scripts (the file extension is .sh) and rename the prefix to "acme_". The following files are the shell scripts that need to be duplicated:
 
 * mydoc_1_multiserve_pdf.sh
 * mydoc_2_multibuild_pdf.sh
diff --git a/mydoc/mydoc_configuration_settings.md b/mydoc/mydoc_configuration_settings.md
index c68f073..e0991b3 100644
--- a/mydoc/mydoc_configuration_settings.md
+++ b/mydoc/mydoc_configuration_settings.md
@@ -15,6 +15,18 @@ The configuration file serves important functions with single sourcing. For each
 
 The configuration file contains most of the settings and other details unique to that site output, such as variables, titles, output directories, build folders, and more.
 
+## Change the project name within the config file
+
+By default, the config file contains the project name, such as mydoc, in numerous places. You can do a find and replace in each of the configuration files to replace "mydoc" with your new project's name. You can also fine tune the configuration settings by looking at what each of them does (as described in the following sections).
+
+## Update the exclude list
+
+By default, all the files in the Jekyll project are included in the output. You have two manually tell Jekyll which files and folders you want to exclude from the output. In  each configuration file there is an `exclude` property that takes a list of items that should be excluded from the build.
+
+In the new configuration file that you created, exclude the mydoc folder and any other mydoc files that you don't want to be output. Similarly, update the mydoc configuration files to exclude the new project that you added.
+ 
+Manually excluding files from the output is one of pain points in Jekyll that I could never solve. Jekyll was not designed for multiple output publishing but was conceived as a way to manage files for a single website.
+
 ## Configuration file variables
 
 You can define arbitrary key-value pairs in the configuration file, and then you can access them through `site.yourkey`, where `yourkey` is the name of the key.