diff --git a/docs/4.0/getting-started/download.md b/docs/4.0/getting-started/download.md index 4685754949..3837d296a5 100644 --- a/docs/4.0/getting-started/download.md +++ b/docs/4.0/getting-started/download.md @@ -6,28 +6,44 @@ group: getting-started toc: true --- -## Bootstrap CSS and JS +## Compiled CSS and JS -**Download Bootstrap's ready-to-use code to easily drop into your project.** Includes compiled and minified versions of all our CSS bundles (default, grid only, or Reboot only) and JavaScript plugins. Doesn't include documentation or source files. +Download ready-to-use compiled code for **Bootstrap v{{ site.current_version}}** to easily drop into your project, which includes: -**Current version:** v{{ site.current_version}} +- Compiled and minified CSS bundles (default, grid-only, and Reboot-only) +- Compiled and minified JavaScript plugins -Download Bootstrap +This doesn't include documentation, source files, or any optional JavaScript dependencies (jQuery and Popper.js). + +Download ## Source files -**Want to compile Bootstrap with your project's asset pipeline?** Choose this option to download our source Sass, JavaScript, and documentation files. Requires a Sass compiler, [Autoprefixer](https://github.com/postcss/autoprefixer), and [some setup]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/build-tools/#tooling-setup). + +Compile Bootstrap with your own asset pipeline by downloading our source Sass, JavaScript, and documentation files. This option requires some additional tooling: + +- Sass compiler (Libsass or Ruby Sass is supported) for compiling your CSS. +- [Autoprefixer](https://github.com/postcss/autoprefixer) for CSS vendor prefixing + +Should you require [build tools]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/build-tools/#tooling-setup), they are included for developing Bootstrap and it's docs, but they're likely unsuitable for your own purposes. Download source ## Bootstrap CDN -Skip the download and use the Bootstrap CDN to deliver Bootstrap's compiled CSS and JS to your project. +Skip the download with the Bootstrap CDN to deliver cached version of Bootstrap's compiled CSS and JS to your project. {% highlight html %} {% endhighlight %} +If you're using our compiled JavaScript, don't forget to include CDN versions of jQuery and Popper.js before it. + +{% highlight html %} + + +{% endhighlight %} + ## Package managers Pull in Bootstrap's **source files** into nearly any project with some of the most popular package managers. No matter the package manager, Bootstrap will **require a Sass compiler and [Autoprefixer](https://github.com/postcss/autoprefixer)** for a setup that matches our official compiled versions.