@mbtest/mountebank 2.9.2-beta.9050

package/src/views/releases/v1.2.56.ejs

@@ -0,0 +1,79 @@
+<h1>v1.2.56</h1>
+
+<p>The following changes are part of this release.</p>
+
+<h2>New Features</h2>
+<ul class='bullet-list'>
+  <li>Richer ways of loading <a href='http://<%= host %>/docs/commandLine#config-file'><code>config files</code></a>,
+  including using templating and loading easily read JavaScript for injection.</li>
+</ul>
+
+<h2>Bug Fixes</h2>
+<ul class='bullet-list'>
+  <li>Minor documentation fixes</li>
+</ul>
+
+<p>Many thanks to the following kind folk for help with this release, for reporting issues
+  and helping to diagnose the problem using the tcp protocol for large requests:</p>
+
+<ul class='bullet-list'>
+  <li>James Thomas</li>
+  <li>Prasanna Kumar</li>
+</ul>
+
+<h2>Install</h2>
+
+<pre><code>
+  npm install -g mountebank@1.2.56 --production
+</code></pre>
+
+<p>or:</p>
+
+<table>
+  <tr>
+    <th>Option</th>
+    <th>node.js required?</th>
+    <th>sudo required?</th>
+    <th>links</th>
+    <th>Description</th>
+  </tr>
+  <tr>
+    <td>Self-contained archives</td>
+    <td>No</td>
+    <td>No</td>
+    <td style="min-width: 5em;">
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v1.2/mountebank-v1.2.56-darwin-x64.tar.gz">osx</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v1.2/mountebank-v1.2.56-linux-x86.tar.gz">linux x86</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v1.2/mountebank-v1.2.56-linux-x64.tar.gz">linux x64</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v1.2/mountebank-v1.2.56-win-x86.zip">win x86</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v1.2/mountebank-v1.2.56-win-x64.zip">win x64</a></li>
+      </ul>
+    </td>
+    <td>Simply unpack and run <code>mb</code> from inside</td>
+  </tr>
+  <tr>
+    <td>OS-specific packages</td>
+    <td>No</td>
+    <td>Yes</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v1.2/mountebank-v1.2.56.pkg">pkg</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v1.2/mountebank-1.2.56-1.x86_64.rpm">rpm</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v1.2/mountebank_1.2.56_amd64.deb">deb</a></li>
+      </ul>
+    </td>
+    <td>Puts <code>mb</code> at <code>/usr/local/bin</code>, which is generally in the <code>PATH</code>.</td>
+  </tr>
+  <tr>
+    <td>source tarball</td>
+    <td>Yes</td>
+    <td>No</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v1.2/mountebank-v1.2.56-npm.tar.gz">mb</a></li>
+      </ul>
+    </td>
+    <td>source tarball if you roll that way.</td>
+  </tr>
+</table>

package/src/views/releases/v1.3.0.ejs

@@ -0,0 +1,86 @@
+<h1>v<%= releaseVersion %></h1>
+
+<p><b>Note that this release changes some default command line behavior.</b>  It's not a breaking change -
+  all previous functionality is still supported, but it means you may need to pass in some additional
+  command line flags (specifically <code>--mock</code> and <code>--debug</code>) to get the same behavior
+  as before, if you depended on either the <code>requests</code> or <code>matches</code> arrays recorded
+  with imposters and stubs previously.The following changes are part of this release.</p>
+
+<h2>New Features</h2>
+<ul class='bullet-list'>
+  <li>Thanks to Paul Phillips, mountebank now works with node v0.12 and v4.0.</li>
+  <li>A <code>timestamp</code> has been added to each element in the <code>requests</code> array
+    to allow for richer verification testing.</li>
+  <li>The <code>matches</code> array is only included if you use the <code>--debug</code> command
+    line parameter.  In practice, this array confused people.  It is still supported,
+    but is only intended for debugging purposes to determine when a stub matches or doesn't.</li>
+  <li>The <code>requests</code> array is only included if you use the <code>--mock</code> command
+    line parameter, and the <code>--nomock</code> parameter no longer matters.  <b>This is the inverse
+    of prior behavior</b> and represents learning that the default use case for most people is to turn
+    off recording requests by default (which represents a memory leak), as many people prefer long
+    running <code>mb</code> instances set up with config files or used for performance testing.</li>
+</ul>
+
+<p>Many thanks to the following kind folk for help with this release:</p>
+
+<ul class='bullet-list'>
+  <li>Paul Phillips</li>
+  <li>Quadir Kareemullah</li>
+</ul>
+
+<h2>Install</h2>
+
+<pre><code>
+  npm install -g mountebank@<%= releaseVersion %> --production
+</code></pre>
+
+<p>or:</p>
+
+<table>
+  <tr>
+    <th>Option</th>
+    <th>node.js required?</th>
+    <th>sudo required?</th>
+    <th>links</th>
+    <th>Description</th>
+  </tr>
+  <tr>
+    <td>Self-contained archives</td>
+    <td>No</td>
+    <td>No</td>
+    <td style="min-width: 5em;">
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-darwin-x64.tar.gz">osx</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x86.tar.gz">linux x86</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x64.tar.gz">linux x64</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x86.zip">win x86</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x64.zip">win x64</a></li>
+      </ul>
+    </td>
+    <td>Simply unpack and run <code>mb</code> from inside</td>
+  </tr>
+  <tr>
+    <td>OS-specific packages</td>
+    <td>No</td>
+    <td>Yes</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>.pkg">pkg</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-<%= releaseVersion %>-1.x86_64.rpm">rpm</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank_<%= releaseVersion %>_amd64.deb">deb</a></li>
+      </ul>
+    </td>
+    <td>Puts <code>mb</code> at <code>/usr/local/bin</code>, which is generally in the <code>PATH</code>.</td>
+  </tr>
+  <tr>
+    <td>source tarball</td>
+    <td>Yes</td>
+    <td>No</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-npm.tar.gz">mb</a></li>
+      </ul>
+    </td>
+    <td>source tarball if you roll that way.</td>
+  </tr>
+</table>

package/src/views/releases/v1.3.1.ejs

@@ -0,0 +1,100 @@
+<h1>v<%= releaseVersion %></h1>
+
+<h2>Bug Fixes</h2>
+<ul class='bullet-list'>
+  <li>Thanks to Snehal Maniar and Sebastian Radloff, the mb.cmd file in the self-contained
+    Windows zip is now portable across any directory you run it from.</li>
+  <li>I've made attempts at reducing the 'path too long' errors unzipping the Windows zip
+    file in Windows Explorer, but it's a pretty fundamental constraint of Explorer.  I provide
+    suggestions on the install page (DEPRECATED as of v2.5).</li>
+  <li>Prevent spurious build failures from pull requests (trying to deploy without the correct environment
+    variables)</li>
+  <li>Some work on making the build more robust against OS-level networking differences, with the help of
+    Avalon McRae and Carson Ramsden</li>
+  <li>Jason Reid fixed a bug preventing AJAX calls to mb from IE</li>
+  <li>Fixed the <a href='http://<%= host %>/feed'>ATOM feed</a></li>
+</ul>
+
+<p>Many thanks to the following kind folk for help with this release:</p>
+
+<ul class='bullet-list'>
+  <li>Snehal Maniar</li>
+  <li>Sebastian Radloff</li>
+  <li>Avalon McRae</li>
+  <li>Carson Ramsden</li>
+  <li>Jason Reid</li>
+</ul>
+
+<h2>Install</h2>
+
+<pre><code>
+  npm install -g mountebank@<%= releaseVersion %> --production
+</code></pre>
+
+<p>or:</p>
+
+<table>
+  <tr>
+    <th>Option</th>
+    <th>node.js required?</th>
+    <th>sudo required?</th>
+    <th>links</th>
+    <th>Description</th>
+  </tr>
+  <tr>
+    <td>Self-contained archives</td>
+    <td>No</td>
+    <td>No</td>
+    <td style="min-width: 5em;">
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-darwin-x64.tar.gz">osx</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x86.tar.gz">linux x86</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x64.tar.gz">linux x64</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x86.zip">win x86<sup>*</sup></a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x64.zip">win x64<sup>*</sup></a></li>
+      </ul>
+    </td>
+    <td>Simply unpack and run <code>mb</code> from inside</td>
+  </tr>
+  <tr>
+    <td>OS-specific packages</td>
+    <td>No</td>
+    <td>Yes</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>.pkg">pkg</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-<%= releaseVersion %>-1.x86_64.rpm">rpm</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank_<%= releaseVersion %>_amd64.deb">deb</a></li>
+      </ul>
+    </td>
+    <td>Puts <code>mb</code> at <code>/usr/local/bin</code>, which is generally in the <code>PATH</code>.</td>
+  </tr>
+  <tr>
+    <td>source tarball</td>
+    <td>Yes</td>
+    <td>No</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-npm.tar.gz">mb</a></li>
+      </ul>
+    </td>
+    <td>source tarball if you roll that way.</td>
+  </tr>
+</table>
+
+<h2 id='windows-path-limitations'>Windows path limitations</h2>
+
+<p><sup>*</sup>mountebank wishes very much for your Windows experience to be hassle-free, but he is simply not qualified to address
+  a particular constraint of Windows Explorer.  For legacy reasons, some Windows applications, including most notably Windows Explorer,
+  have a maximum number of characters allowed in a path of 260 characters.  As mountebank writes these words, the longest path he
+  includes in the zip files is around 175 characters.  The zip file name, which is likely to represent itself as <i>two</i>
+  nested directories if you use the defaults to unzip it, will be around 25 characters.  That gives you very little wiggle room.
+  If you unzip the file in your users directory, you may very likely get an error because of this constraint.</p>
+
+<p>The following solutions will all work:</p>
+
+<ul class='bullet-list'>
+  <li>Unzip to the root of your C: drive (or a similar small path)</li>
+  <li>Use <a href='http://www.7-zip.org/'>7zip</a> to unzip the file instead of Windows Explorer</li>
+  <li>Use <code>npm</code> to install mountebank instead of the zip file</li>
+</ul>

package/src/views/releases/v1.4.0.ejs

@@ -0,0 +1,96 @@
+<h1>v<%= releaseVersion %></h1>
+
+<h2>New Features</h2>
+<ul class='bullet-list'>
+  <li>A new <a href='http://<%= host %>/docs/api/xpath'>xpath predicate parameter</a></li>
+  <li>Support for node 4.2</li>
+  <li>Updated examples and
+    <a href='http://<%= host %>/docs/communityExtensions'>clientLibraries</a></li>
+</ul>
+
+<h2>Bug Fixes</h2>
+<ul class='bullet-list'>
+  <li><code>deepEquals</code> predicates that match on multi-value keys (e.g. repeating
+  querystring keys) no longer depend on the order of the keys matching between the request
+  and the predicate</li>
+</ul>
+
+<p>Many thanks to the following kind folk for help with this release:</p>
+
+<ul class='bullet-list'>
+  <li>Natalia Pedan</li>
+</ul>
+
+<h2>Install</h2>
+
+<pre><code>
+  npm install -g mountebank@<%= releaseVersion %> --production
+</code></pre>
+
+<p>or:</p>
+
+<table>
+  <tr>
+    <th>Option</th>
+    <th>node.js required?</th>
+    <th>sudo required?</th>
+    <th>links</th>
+    <th>Description</th>
+  </tr>
+  <tr>
+    <td>Self-contained archives</td>
+    <td>No</td>
+    <td>No</td>
+    <td style="min-width: 5em;">
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-darwin-x64.tar.gz">osx</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x86.tar.gz">linux x86</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x64.tar.gz">linux x64</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x86.zip">win x86<sup>*</sup></a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x64.zip">win x64<sup>*</sup></a></li>
+      </ul>
+    </td>
+    <td>Simply unpack and run <code>mb</code> from inside</td>
+  </tr>
+  <tr>
+    <td>OS-specific packages</td>
+    <td>No</td>
+    <td>Yes</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>.pkg">pkg</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-<%= releaseVersion %>-1.x86_64.rpm">rpm</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank_<%= releaseVersion %>_amd64.deb">deb</a></li>
+      </ul>
+    </td>
+    <td>Puts <code>mb</code> at <code>/usr/local/bin</code>, which is generally in the <code>PATH</code>.</td>
+  </tr>
+  <tr>
+    <td>source tarball</td>
+    <td>Yes</td>
+    <td>No</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-npm.tar.gz">mb</a></li>
+      </ul>
+    </td>
+    <td>source tarball if you roll that way.</td>
+  </tr>
+</table>
+
+<h2 id='windows-path-limitations'>Windows path limitations</h2>
+
+<p><sup>*</sup>mountebank wishes very much for your Windows experience to be hassle-free, but he is simply not qualified to address
+  a particular constraint of Windows Explorer.  For legacy reasons, some Windows applications, including most notably Windows Explorer,
+  have a maximum number of characters allowed in a path of 260 characters.  As mountebank writes these words, the longest path he
+  includes in the zip files is around 175 characters.  The zip file name, which is likely to represent itself as <i>two</i>
+  nested directories if you use the defaults to unzip it, will be around 25 characters.  That gives you very little wiggle room.
+  If you unzip the file in your users directory, you may very likely get an error because of this constraint.</p>
+
+<p>The following solutions will all work:</p>
+
+<ul class='bullet-list'>
+  <li>Unzip to the root of your C: drive (or a similar small path)</li>
+  <li>Use <a href='http://www.7-zip.org/'>7zip</a> to unzip the file instead of Windows Explorer</li>
+  <li>Use <code>npm</code> to install mountebank instead of the zip file</li>
+</ul>

package/src/views/releases/v1.4.1.ejs

@@ -0,0 +1,103 @@
+<h1>v<%= releaseVersion %></h1>
+
+<p>v<%= releaseVersion %> is primarily a documentation release.</p>
+
+<h2>New Features</h2>
+<ul class='bullet-list'>
+  <li>A new and exciting <a href='http://<%= host %>/docs/api/contracts'>JSON contract explorer</a> to help you
+  navigate the mountebank API.</li>
+  <li>Improved documentation for <a href='http://<%= host %>/docs/protocols/https'>https mutual authentication</a></li>
+  <li>Renamed stub resolver to response type for clarity</li>
+  <li>Changed the <a href='http://<%= host %>/docs/api/proxies'>tcp proxy <code>to</code> field</a> to a URL string
+  to match the format of the http <code>to</code> field.  This is a backwards-compatible change; the old object
+  format will still be honored.</li>
+</ul>
+
+<h2>Bug Fixes</h2>
+<ul class='bullet-list'>
+  <li>Fixed the JSON /logs resource</li>
+  <li>Erroring if multiple response types included in single response configuration</li>
+  <li>Maintain the case of http headers (<a href='https://github.com/mountebank-testing/mountebank/issues/75'>issue 75</a>)</li>
+</ul>
+
+<p>Many thanks to the following kind folk for help with this release:</p>
+
+<ul class='bullet-list'>
+  <li>Nils Janson</li>
+  <li>Sean Bennett</li>
+  <li>Cannon Biggs</li>
+</ul>
+
+<h2>Install</h2>
+
+<pre><code>
+  npm install -g mountebank@<%= releaseVersion %> --production
+</code></pre>
+
+<p>or:</p>
+
+<table>
+  <tr>
+    <th>Option</th>
+    <th>node.js required?</th>
+    <th>sudo required?</th>
+    <th>links</th>
+    <th>Description</th>
+  </tr>
+  <tr>
+    <td>Self-contained archives</td>
+    <td>No</td>
+    <td>No</td>
+    <td style="min-width: 5em;">
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-darwin-x64.tar.gz">osx</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x86.tar.gz">linux x86</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x64.tar.gz">linux x64</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x86.zip">win x86<sup>*</sup></a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x64.zip">win x64<sup>*</sup></a></li>
+      </ul>
+    </td>
+    <td>Simply unpack and run <code>mb</code> from inside</td>
+  </tr>
+  <tr>
+    <td>OS-specific packages</td>
+    <td>No</td>
+    <td>Yes</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>.pkg">pkg</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-<%= releaseVersion %>-1.x86_64.rpm">rpm</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank_<%= releaseVersion %>_amd64.deb">deb</a></li>
+      </ul>
+    </td>
+    <td>Puts <code>mb</code> at <code>/usr/local/bin</code>, which is generally in the <code>PATH</code>.</td>
+  </tr>
+  <tr>
+    <td>source tarball</td>
+    <td>Yes</td>
+    <td>No</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-npm.tar.gz">mb</a></li>
+      </ul>
+    </td>
+    <td>source tarball if you roll that way.</td>
+  </tr>
+</table>
+
+<h2 id='windows-path-limitations'>Windows path limitations</h2>
+
+<p><sup>*</sup>mountebank wishes very much for your Windows experience to be hassle-free, but he is simply not qualified to address
+  a particular constraint of Windows Explorer.  For legacy reasons, some Windows applications, including most notably Windows Explorer,
+  have a maximum number of characters allowed in a path of 260 characters.  As mountebank writes these words, the longest path he
+  includes in the zip files is around 175 characters.  The zip file name, which is likely to represent itself as <i>two</i>
+  nested directories if you use the defaults to unzip it, will be around 25 characters.  That gives you very little wiggle room.
+  If you unzip the file in your users directory, you may very likely get an error because of this constraint.</p>
+
+<p>The following solutions will all work:</p>
+
+<ul class='bullet-list'>
+  <li>Unzip to the root of your C: drive (or a similar small path)</li>
+  <li>Use <a href='http://www.7-zip.org/'>7zip</a> to unzip the file instead of Windows Explorer</li>
+  <li>Use <code>npm</code> to install mountebank instead of the zip file</li>
+</ul>

package/src/views/releases/v1.4.2.ejs

@@ -0,0 +1,100 @@
+<h1>v<%= releaseVersion %></h1>
+
+<p class='info-icon'>Be sure to keep up with the latest releases by subscribing to the
+<a href='http://<%= host %>/feed'>ATOM feed</a>.</p>
+
+<h2>New Features</h2>
+<ul class='bullet-list'>
+  <li>node v5.0 support</li>
+  <li>Various documentation updates</li>
+  <li>Reset logfile on startup so it's specific to the currently running instance</li>
+  <li>Support tailing the log through <a href='http://<%= host %>/logs'>the UI</a></li>
+  <li>No longer adding XHR requests to the logs</li>
+  <li>Including all JavaScript sources locally so the site runs locally without a network connection</li>
+</ul>
+
+<h2>Bug Fixes</h2>
+<ul class='bullet-list'>
+  <li>No longer validating injected JavaScript functions during imposter creation.  This created
+  too many edge cases that were very difficult to debug and leaked a validation abstraction to end users.</li>
+</ul>
+
+<p>Many thanks to the following kind folk for help with this release:</p>
+
+<ul class='bullet-list'>
+  <li>Cannon Biggs</li>
+</ul>
+
+<h2>Install</h2>
+
+<pre><code>
+  npm install -g mountebank@<%= releaseVersion %>
+</code></pre>
+
+<p>or:</p>
+
+<table>
+  <tr>
+    <th>Option</th>
+    <th>node.js required?</th>
+    <th>sudo required?</th>
+    <th>links</th>
+    <th>Description</th>
+  </tr>
+  <tr>
+    <td>Self-contained archives</td>
+    <td>No</td>
+    <td>No</td>
+    <td style="min-width: 5em;">
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-darwin-x64.tar.gz">osx</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x86.tar.gz">linux x86</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x64.tar.gz">linux x64</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x86.zip">win x86<sup>*</sup></a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x64.zip">win x64<sup>*</sup></a></li>
+      </ul>
+    </td>
+    <td>Simply unpack and run <code>mb</code> from inside</td>
+  </tr>
+  <tr>
+    <td>OS-specific packages</td>
+    <td>No</td>
+    <td>Yes</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>.pkg">pkg</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-<%= releaseVersion %>-1.x86_64.rpm">rpm</a></li>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank_<%= releaseVersion %>_amd64.deb">deb</a></li>
+      </ul>
+    </td>
+    <td>Puts <code>mb</code> at <code>/usr/local/bin</code>, which is generally in the <code>PATH</code>.</td>
+  </tr>
+  <tr>
+    <td>source tarball</td>
+    <td>Yes</td>
+    <td>No</td>
+    <td>
+      <ul>
+        <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-npm.tar.gz">mb</a></li>
+      </ul>
+    </td>
+    <td>source tarball if you roll that way.</td>
+  </tr>
+</table>
+
+<h2 id='windows-path-limitations'>Windows path limitations</h2>
+
+<p><sup>*</sup>mountebank wishes very much for your Windows experience to be hassle-free, but he is simply not qualified to address
+  a particular constraint of Windows Explorer.  For legacy reasons, some Windows applications, including most notably Windows Explorer,
+  have a maximum number of characters allowed in a path of 260 characters.  As mountebank writes these words, the longest path he
+  includes in the zip files is around 175 characters.  The zip file name, which is likely to represent itself as <i>two</i>
+  nested directories if you use the defaults to unzip it, will be around 25 characters.  That gives you very little wiggle room.
+  If you unzip the file in your users directory, you may very likely get an error because of this constraint.</p>
+
+<p>The following solutions will all work:</p>
+
+<ul class='bullet-list'>
+  <li>Unzip to the root of your C: drive (or a similar small path)</li>
+  <li>Use <a href='http://www.7-zip.org/'>7zip</a> to unzip the file instead of Windows Explorer</li>
+  <li>Use <code>npm</code> to install mountebank instead of the zip file</li>
+</ul>