Skip to content

Commit 7bd9a8b

Browse files
committed
revert removal of paragraph and instead clarify 'serve jQuery to users in China'
1 parent 2ef1629 commit 7bd9a8b

File tree

2 files changed

+24
-0
lines changed

2 files changed

+24
-0
lines changed

dist/doc/html.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -155,6 +155,18 @@ the bottom of the page. A local fallback of jQuery is included for rare instance
155155
when the CDN version might not be available, and to facilitate offline
156156
development.
157157

158+
The jQuery CDN version was chosen over other potential candidates
159+
([like Google's Hosted Libraries](https://developers.google.com/speed/libraries/))
160+
because it's fast ([comparable or faster than Google by some
161+
measures](https://www.cdnperf.com/#jsdelivr,cdnjs,google,yandex,microsoft,jquery,bootstrapcdn/https/90))
162+
and, (unlike Google's CDN) is available to China's hundreds of millions of internet users.
163+
For many years we [chose](https://github.com/h5bp/html5-boilerplate/issues/1191)
164+
the Google Hosted version over the jQuery CDN because it was available
165+
over HTTPS (the jQuery CDN was not,) and it offered a better chance of
166+
hitting the cache lottery owing to the popularity of the Google CDN.
167+
The first issue is no longer valid and the second is far outweighed by
168+
being able to serve jQuery to users in China.
169+
158170
While the jQuery CDN is a strong default solution your site or application may
159171
require a different configuration. Testing your site with services like
160172
[WebPageTest](https://www.webpagetest.org/) and browser tools like

src/doc/html.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -155,6 +155,18 @@ the bottom of the page. A local fallback of jQuery is included for rare instance
155155
when the CDN version might not be available, and to facilitate offline
156156
development.
157157

158+
The jQuery CDN version was chosen over other potential candidates
159+
([like Google's Hosted Libraries](https://developers.google.com/speed/libraries/))
160+
because it's fast ([comparable or faster than Google by some
161+
measures](https://www.cdnperf.com/#jsdelivr,cdnjs,google,yandex,microsoft,jquery,bootstrapcdn/https/90))
162+
and, (unlike Google's CDN) is available to China's hundreds of millions of internet users.
163+
For many years we [chose](https://github.com/h5bp/html5-boilerplate/issues/1191)
164+
the Google Hosted version over the jQuery CDN because it was available
165+
over HTTPS (the jQuery CDN was not,) and it offered a better chance of
166+
hitting the cache lottery owing to the popularity of the Google CDN.
167+
The first issue is no longer valid and the second is far outweighed by
168+
being able to serve jQuery to users in China.
169+
158170
While the jQuery CDN is a strong default solution your site or application may
159171
require a different configuration. Testing your site with services like
160172
[WebPageTest](https://www.webpagetest.org/) and browser tools like

0 commit comments

Comments
 (0)