diff --git a/docs/getting-started/contents.md b/docs/getting-started/contents.md index 9fb6a6ced1..999a9b8a8c 100644 --- 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: diff --git a/docs/layout/media-queries.md b/docs/layout/media-queries.md index 8ae957890e..a72469603b 100644 --- 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) { ... }