Merge pull request #29 from PagerDuty/fix-pre-region

Fix install instructions preformat block and add a copy in the User Guide

README.rst

@@ -3,16 +3,17 @@ python-pagerduty: Clients for PagerDuty's APIs
 ==============================================
 A module that supplies lightweight Python clients for the PagerDuty REST API v2 and Events API v2.
 
-For how-to, refer to the `User Guide
+For in-depth usage documentation, refer to the `User Guide
 <https://pagerduty.github.io/python-pagerduty/user_guide.html>`_.
 
 Installation
 ------------
-This library is available on PyPI as [pagerduty](https://pypi.org/project/pagerduty/), e.g.: 
+This library is available on PyPI as `pagerduty <https://pypi.org/project/pagerduty/>`_, e.g.: 
+
+.. code-block:: bash
+
+    pip install pagerduty
 
-```
-pip install pagerduty
-```
 
 Overview
 --------

docs/index.html

@@ -90,6 +90,7 @@ <h2>Table of Contents<a class="headerlink" href="#table-of-contents" title="Perm
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="changelog.html">Changelog</a></li>
 <li class="toctree-l1"><a class="reference internal" href="user_guide.html">User Guide</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="user_guide.html#installation">Installation</a></li>
 <li class="toctree-l2"><a class="reference internal" href="user_guide.html#authentication">Authentication</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="user_guide.html#using-non-us-service-regions">Using Non-US Service Regions</a></li>
 <li class="toctree-l3"><a class="reference internal" href="user_guide.html#the-from-header">The From header</a></li>

docs/user_guide.html

@@ -45,6 +45,7 @@
               <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="changelog.html">Changelog</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">User Guide</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="#installation">Installation</a></li>
 <li class="toctree-l2"><a class="reference internal" href="#authentication">Authentication</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="#using-non-us-service-regions">Using Non-US Service Regions</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#the-from-header">The From header</a></li>
@@ -120,6 +121,13 @@
 <span id="id1"></span><h1>User Guide<a class="headerlink" href="#user-guide" title="Permalink to this heading"></a></h1>
 <p>This is a topical guide to general API client usage. <a class="reference internal" href="module_reference.html#module-reference"><span class="std std-ref">Module Reference</span></a>
 has in-depth documentation on client classes and methods.</p>
+<section id="installation">
+<h2>Installation<a class="headerlink" href="#installation" title="Permalink to this heading"></a></h2>
+<p>This library is available on PyPI as <a class="reference external" href="https://pypi.org/project/pagerduty/">pagerduty</a>, e.g.:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip install pagerduty
+</pre></div>
+</div>
+</section>
 <section id="authentication">
 <h2>Authentication<a class="headerlink" href="#authentication" title="Permalink to this heading"></a></h2>
 <p>The first step is to construct a client object. The first argument to the

sphinx/source/user_guide.rst

@@ -7,6 +7,17 @@ User Guide
 This is a topical guide to general API client usage. :ref:`module_reference`
 has in-depth documentation on client classes and methods.
 
+
+
+Installation
+------------
+This library is available on PyPI as `pagerduty <https://pypi.org/project/pagerduty/>`_, e.g.: 
+
+.. code-block:: bash
+
+    pip install pagerduty
+
+
 Authentication
 --------------
 The first step is to construct a client object. The first argument to the