docs twerks

diff --git a/docs/getting-started/contents.md b/docs/getting-started/contents.md
index 9fb6a6ced1766831412002012fb33611c021b532..999a9b8a8c1bb3f37b5dda986010501d39478970 100644 (file)
--- a/docs/getting-started/contents.md
+++ b/docs/getting-started/contents.md
@@ -4,22 +4,11 @@ title: Contents
 group: getting-started
 ---
 
-Bootstrap can come in one of two forms, as precompiled or source code. Learn more about each form's contents and structure below.
-
-{% callout warning %}
-#### jQuery required
-
-Please note that **all JavaScript plugins require jQuery** to be included, as shown in the [starter template](../quick-start). [Consult our `bower.json`]({{ site.repo }}/blob/v{{ site.current_version }}/bower.json) to see which versions of jQuery are supported.
-{% endcallout %}
-
-## Contents
-
-* Will be replaced with the ToC, excluding the "Contents" header
-{:toc}
+Bootstrap can come in one of two forms, as precompiled or source code. Learn more about each flavor's contents and structure below. Remember, no matter the implementation flavor, **Bootstrap's JavaScript plugins require jQuery**.
 
 ## Precompiled Bootstrap
 
-Once downloaded, unzip the compressed folder to see the structure of (the compiled) Bootstrap. You'll see something like this:
+Once downloaded, unzip the compressed folder and you'll see something like this:
 
 <!-- NOTE: This info is intentionally duplicated in the README. Copy any changes made here over to the README too. -->
 

diff --git a/docs/layout/media-queries.md b/docs/layout/media-queries.md
index 8ae957890e04613bf8fe3983dd2b28d8d53c81da..a72469603bf52a022c1b0acfeb354d3ef3d7bff7 100644 (file)
--- a/docs/layout/media-queries.md
+++ b/docs/layout/media-queries.md
@@ -4,9 +4,9 @@ title: Media queries
 group: layout
 ---
 
-Since Bootstrap is designed to be mobile-first, we employ media queries in our CSS to create responsive pages and components.
+Since Bootstrap is responsive and designed to be mobile-first, we employ media queries in our CSS to create responsive pages and components that scale to particular viewports and devices.
 
-Media queries allow you to group rulesets by a handful of parameters, most notably viewport dimensions, to gracefully scale content across devices. Bootstrap mainly uses the following media query ranges in our source Sass files for key breakpoints in our layout, grid system, and components.
+Media queries allow you to group rulesets by a handful of parameters, most notably viewport dimensions, to gracefully scale content across devices. Bootstrap primarily uses the following media query ranges—we call them breakpoints—in our source Sass files for our layout, grid system, and components.
 
 {% highlight scss %}
 /* Extra small devices (portrait phones, less than ???px) */
@@ -25,7 +25,8 @@ Media queries allow you to group rulesets by a handful of parameters, most notab
 @media (min-width: 75em) { ... }
 {% endhighlight %}
 
-These media queries are available via Sass mixins:
+Since we write our source CSS in Sass, all our media queries are available via Sass mixins:
+
 {% highlight scss %}
 @include media-breakpoint-up(xs) { ... }
 @include media-breakpoint-up(sm) { ... }
@@ -42,6 +43,7 @@ These media queries are available via Sass mixins:
 {% endhighlight %}
 
 We occasionally use media queries that go in the other direction (the given screen size *or smaller*):
+
 {% highlight scss %}
 /* Extra small devices (portrait phones, less than 34em) */
 @media (max-width: 33.9em) { ... }
@@ -59,7 +61,8 @@ We occasionally use media queries that go in the other direction (the given scre
 /* No media query since the extra-large breakpoint has no upper bound on its width */
 {% endhighlight %}
 
-These media queries are available via Sass mixins:
+Once again, these media queries are also available via Sass mixins:
+
 {% highlight scss %}
 @include media-breakpoint-down(xs) { ... }
 @include media-breakpoint-down(sm) { ... }