More intro edits

docs/index.html

@@ -996,7 +996,7 @@ <h1 id="preface">Fundamentals of DevOps and Software Delivery</h1>
 
 <div class="paragraph">
 
-<p>Whereas most DevOps content tends to focus primarily on culture and theory, this series is a <em>hands-on
+<p>Whereas most DevOps content tends to focus on culture and theory, this series is a <em>hands-on
 
 guide</em> that includes dozens of examples that walk you, step-by-step, through how to run real systems and real code.
 
@@ -1464,6 +1464,16 @@ <h2 id="_where_devops_came_from">Where DevOps Came From</h2>
 
 </div>
 
+<div class="paragraph">
+
+<p>These are remarkable results, and if you can successfully learn and apply DevOps practices at your own company, you
+
+may achieve similar results. However, a fair warning: while the result can be wonderful, the experience along the way
+
+can be anything but wonderful, as described next.</p>
+
+</div>
+
 </div>
 
 <div class="sect2">
@@ -1472,9 +1482,7 @@ <h2 id="box_of_snakes">Watch Out for Snakes</h2>
 
 <div class="paragraph">
 
-<p>Although some companies have achieved wonderful results by using DevOps, the experience along the way can be anything
-
-but wonderful. In part, this is because we use a single word, "DevOps," to describe what&#8217;s actually dozens and dozens
+<p>I&#8217;m going to let you in on a little secret: we use a single word, "DevOps," to describe what&#8217;s actually dozens and dozens
 
 of largely unrelated concepts. What does the cryptography behind a TLS certificate have to do with defining a deployment
 
@@ -1518,7 +1526,7 @@ <h2 id="box_of_snakes">Watch Out for Snakes</h2>
 
 <p>My hope in this blog post series is, as much as I can, to untangle this mess of cables for you. To show you that these
 
-are, in fact, separate wires that are not that hard to understand in isolation.</p>
+are, in fact, separate cables—separate concepts—that are not that hard to understand in isolation.</p>
 
 </div>
 
@@ -1530,25 +1538,39 @@ <h2 id="box_of_snakes">Watch Out for Snakes</h2>
 
 yourself sitting there, staring at some nonsense error message, tearing your hair out, stressed, angry, and afraid,
 
-know this: you are not alone. There are thousands of other developers pulling their hair out over DevOps, just like you.</p>
+know this:</p>
 
 </div>
 
 <div class="paragraph">
 
-<p>I&#8217;m one of them. I&#8217;ve lost more hair to DevOps than I care to admit. Even while writing this blog post series, I
+<p>You are not alone.</p>
+
+</div>
 
-frequently found myself frustrated, or confused, or yelling at my screen, even though I&#8217;ve done most of these things a
+<div class="paragraph">
+
+<p>There are thousands of other developers reaching into that box of snakes and getting bitten, every day. I&#8217;m one of
+
+them. I&#8217;ve lost more hair to DevOps than I care to admit. Even while writing this blog post series, I frequently found
+
+myself frustrated, or confused, or yelling at my screen, even though I&#8217;ve done most of these things a
+
+thousand times. That&#8217;s just how it is today.</p>
+
+</div>
+
+<div class="paragraph">
 
-thousand times. It&#8217;s just how it is today. In fact, there are a few places in this series where I
+<p>In fact, there are a few places in this series where I haven&#8217;t been able to untangle the wires as much
 
-haven&#8217;t been able to untangle the wires as much as I&#8217;d like: e.g., some example code that&#8217;s just too complicated and
+as I&#8217;d like: e.g., some example code that&#8217;s just too complicated and long to include in the blog post series, so I have
 
-long to include in the blog post series, so I have to settle for a simpler and less realistic version, or a concept I
+to settle for a simpler and less realistic version, or a concept I can&#8217;t explain without introducing ten other concepts
 
-can&#8217;t explain without introducing ten other concepts that come later, so I can only give you a partial explanation for
+that come later, so I can only give you a partial explanation for now. In cases like these, I&#8217;ve added a "box of
 
-now. In cases like these, I&#8217;ve added a "box of snakes" warning that looks like this:</p>
+snakes" warning that looks like this:</p>
 
 </div>