Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions pages/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,18 @@ Please read the [2.0 release notes](http://blog.jquery.com/2013/04/18/jquery-2-0

[jQuery 2.1.0 release notes](http://blog.jquery.com/?p=3344)

## Downloading jQuery using Bower
jQuery is registered as a package with [Bower](http://bower.io). You can install the latest version of jQuery with the command:
```
bower install jquery
```
This will install jQuery to Bower's install directory, the default being `bower_components`. Within `bower_components/jquery/dist/` you will find an uncompressed release, a compressed release, and a map file.

The jQuery Bower package contains additional files besides the default distribution. In most cases you can ignore these files, however if you wish to download the default release on it's own you can use Bower to install jQuery from one of the above urls instead of the registered package. For example, if you wish to install just the compressed jQuery 2.1.0, you can install just that file with the following command:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems like an odd thing for us to document.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documented this at the request of @dmethvin in PR jquery/jquery/pull/1542. The idea being that this may cut down on the volume of complaints concerning the amount of files downloaded when requesting the jQuery package through Bower.

What's the reason for it being "odd"?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documented this at the request of @dmethvin

I don't see where he asked for this. Can you point to the specific comment?

What's the reason for it being "odd"?

Are there any other projects telling people how to use Bower to install arbitrary files instead of actual packages?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dmethvin asked here: jquery/jquery#1542 (comment)

I don't know off hand if any other projects mention doing this but installing an arbitrary file instead of an actual package is described here: http://bower.io/#installing-packages-and-dependencies, in the last bullet point under "Where <package> can be any one of the following"

This obviously isn't the best way to install jQuery but according to what @dmethvin has said, there seems to be a number of people who for one reason or another have a problem with getting more than just jquery.js from the Bower package. This update the documentation is attempting to highlight an alternative in case they didn't think of it on their own.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ornj I don't know whether you PR will land nor can I influence in any way. However, if it is accepted it would be great if you could fix a small typo: on it's own -> on its own. Thanks :-)

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I always mess that up. I think someone else is going to work on this but thanks for the copy edit.

```
bower install http://code.jquery.com/jquery-2.1.0.min.js
```

## jQuery Migrate Plugin

We have created the [jQuery Migrate plugin](http://github.com/jquery/jquery-migrate/#readme)
Expand Down