Skip to content
This repository
Browse code

Remove superfluous code comments

Reduce the perceived complexity and verbosity of certain files by
stripping unneccessary inline comments.

Relevant documentation may end up in a `doc/` directory such that any
download has an accurate and matching code documentation bundle.

Ref gh-1048
commit 889e377b2d20eaaa690785d7e47daf50aa46b972 1 parent d396948
Nicolas Gallagher authored July 29, 2012
115  .htaccess
... ...
@@ -1,8 +1,8 @@
1 1
 # Apache configuration file
2 2
 # httpd.apache.org/docs/2.2/mod/quickreference.html
3 3
 
4  
-# Note .htaccess files are an overhead, this logic should be in your Apache config if possible
5  
-# httpd.apache.org/docs/2.2/howto/htaccess.html
  4
+# Note .htaccess files are an overhead, this logic should be in your Apache
  5
+# config if possible: httpd.apache.org/docs/2.2/howto/htaccess.html
6 6
 
7 7
 # Techniques in here adapted from all over, including:
8 8
 #   Kroc Camen: camendesign.com/.htaccess
@@ -10,13 +10,6 @@
10 10
 #   Sample .htaccess file of CMS MODx: modxcms.com
11 11
 
12 12
 
13  
-###
14  
-### If you run a webserver other than Apache, consider:
15  
-### github.com/h5bp/server-configs
16  
-###
17  
-
18  
-
19  
-
20 13
 # ----------------------------------------------------------------------
21 14
 # Better website experience for IE users
22 15
 # ----------------------------------------------------------------------
@@ -83,12 +76,10 @@
83 76
 </IfModule>
84 77
 
85 78
 
86  
-
87 79
 # ----------------------------------------------------------------------
88 80
 # Proper MIME type for all files
89 81
 # ----------------------------------------------------------------------
90 82
 
91  
-
92 83
 # JavaScript
93 84
 #   Normalize to standard type (it's sniffed in IE anyways)
94 85
 #   tools.ietf.org/html/rfc4329#section-7.2
@@ -143,15 +134,14 @@ AddType text/vtt                            vtt
143 134
 # and they would be included into this single file.
144 135
 
145 136
 # This is not in use in the boilerplate as it stands. You may
146  
-# choose to name your files in this way for this advantage or
147  
-# concatenate and minify them manually.
148  
-# Disabled by default.
  137
+# choose to use this technique if you do not have a build process.
149 138
 
150 139
 #<FilesMatch "\.combined\.js$">
151 140
 #  Options +Includes
152 141
 #  AddOutputFilterByType INCLUDES application/javascript application/json
153 142
 #  SetOutputFilter INCLUDES
154 143
 #</FilesMatch>
  144
+
155 145
 #<FilesMatch "\.combined\.css$">
156 146
 #  Options +Includes
157 147
 #  AddOutputFilterByType INCLUDES text/css
@@ -217,8 +207,8 @@ AddType text/vtt                            vtt
217 207
 # Additionally, consider that outdated proxies may miscache
218 208
 #   www.stevesouders.com/blog/2008/08/23/revving-filenames-dont-use-querystring/
219 209
 
220  
-# If you don't use filenames to version, lower the CSS  and JS to something like
221  
-#   "access plus 1 week" or so.
  210
+# If you don't use filenames to version, lower the CSS and JS to something like
  211
+# "access plus 1 week".
222 212
 
223 213
 <IfModule mod_expires.c>
224 214
   ExpiresActive on
@@ -269,19 +259,20 @@ AddType text/vtt                            vtt
269 259
 
270 260
 </IfModule>
271 261
 
  262
+
272 263
 # ----------------------------------------------------------------------
273 264
 # Prevent mobile network providers from modifying your site
274 265
 # ----------------------------------------------------------------------
275 266
 
276  
-# The following header prevents modification of your code over 3G on some European providers
277  
-# This is the official 'bypass' suggested by O2 in the UK
  267
+# The following header prevents modification of your code over 3G on some
  268
+# European providers.
  269
+# This is the official 'bypass' suggested by O2 in the UK.
278 270
 
279 271
 # <IfModule mod_headers.c>
280 272
 # Header set Cache-Control "no-transform"
281 273
 # </IfModule>
282 274
 
283 275
 
284  
-
285 276
 # ----------------------------------------------------------------------
286 277
 # ETag removal
287 278
 # ----------------------------------------------------------------------
@@ -297,14 +288,12 @@ AddType text/vtt                            vtt
297 288
 FileETag None
298 289
 
299 290
 
300  
-
301 291
 # ----------------------------------------------------------------------
302 292
 # Stop screen flicker in IE on CSS rollovers
303 293
 # ----------------------------------------------------------------------
304 294
 
305 295
 # The following directives stop screen flicker in IE on CSS rollovers - in
306  
-# combination with the "ExpiresByType" rules for images (see above). If
307  
-# needed, un-comment the following rules.
  296
+# combination with the "ExpiresByType" rules for images (see above).
308 297
 
309 298
 # BrowserMatch "MSIE" brokenvary=1
310 299
 # BrowserMatch "Mozilla/4.[0-9]{2}" brokenvary=1
@@ -312,43 +301,41 @@ FileETag None
312 301
 # SetEnvIf brokenvary 1 force-no-vary
313 302
 
314 303
 
315  
-
316 304
 # ----------------------------------------------------------------------
317 305
 # Set Keep-Alive Header
318 306
 # ----------------------------------------------------------------------
319 307
 
320  
-# Keep-Alive allows the server to send multiple requests through one TCP-connection.
321  
-# Be aware of possible disadvantages of this setting. Turn on if you serve a lot of
322  
-# static content.
  308
+# Keep-Alive allows the server to send multiple requests through one
  309
+# TCP-connection. Be aware of possible disadvantages of this setting. Turn on
  310
+# if you serve a lot of static content.
323 311
 
324 312
 # <IfModule mod_headers.c>
325 313
 #   Header set Connection Keep-Alive
326 314
 # </IfModule>
327 315
 
328 316
 
329  
-
330 317
 # ----------------------------------------------------------------------
331 318
 # Cookie setting from iframes
332 319
 # ----------------------------------------------------------------------
333 320
 
334 321
 # Allow cookies to be set from iframes (for IE only)
335  
-# If needed, uncomment and specify a path or regex in the Location directive
  322
+# If needed, specify a path or regex in the Location directive.
336 323
 
337 324
 # <IfModule mod_headers.c>
338 325
 #   Header set P3P "policyref=\"/w3c/p3p.xml\", CP=\"IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT\""
339 326
 # </IfModule>
340 327
 
341 328
 
342  
-
343 329
 # ----------------------------------------------------------------------
344 330
 # Start rewrite engine
345 331
 # ----------------------------------------------------------------------
346 332
 
347  
-# Turning on the rewrite engine is necessary for the following rules and features.
348  
-# FollowSymLinks must be enabled for this to work.
  333
+# Turning on the rewrite engine is necessary for the following rules and
  334
+# features. FollowSymLinks must be enabled for this to work.
349 335
 #
350  
-# Some cloud hosting services require RewriteBase to be set: goo.gl/HOcPN
351  
-# If using the h5bp in a subdirectory, use `RewriteBase /foo` instead where 'foo' is your directory.
  336
+# Some cloud hosting services require RewriteBase to be set: goo.gl/HOcPN If
  337
+# using the h5bp in a subdirectory, use `RewriteBase /foo` instead where 'foo'
  338
+# is your directory.
352 339
 
353 340
 <IfModule mod_rewrite.c>
354 341
   Options +FollowSymlinks
@@ -357,26 +344,27 @@ FileETag None
357 344
 </IfModule>
358 345
 
359 346
 
360  
-
361 347
 # ----------------------------------------------------------------------
362 348
 # Suppress or force the "www." at the beginning of URLs
363 349
 # ----------------------------------------------------------------------
364 350
 
365  
-# The same content should never be available under two different URLs - especially not with and
366  
-# without "www." at the beginning, since this can cause SEO problems (duplicate content).
367  
-# That's why you should choose one of the alternatives and redirect the other one.
  351
+# The same content should never be available under two different URLs -
  352
+# especially not with and without "www." at the beginning, since this can cause
  353
+# SEO problems (duplicate content). That's why you should choose one of the
  354
+# alternatives and redirect the other one.
368 355
 
369  
-# By default option 1 (no "www.") is activated. Remember: Shorter URLs are sexier.
  356
+# By default option 1 (no "www.") is activated.
370 357
 # no-www.org/faq.php?q=class_b
371 358
 
372  
-# If you rather want to use option 2, just comment out all option 1 lines
  359
+# If you'd prefer to use option 2, just comment out all option 1 lines
373 360
 # and uncomment option 2.
  361
+
374 362
 # IMPORTANT: NEVER USE BOTH RULES AT THE SAME TIME!
375 363
 
376 364
 # ----------------------------------------------------------------------
377 365
 
378 366
 # Option 1:
379  
-# Rewrite "www.example.com -> example.com"
  367
+# Rewrite "www.example.com -> example.com".
380 368
 
381 369
 <IfModule mod_rewrite.c>
382 370
   RewriteCond %{HTTPS} !=on
@@ -387,9 +375,9 @@ FileETag None
387 375
 # ----------------------------------------------------------------------
388 376
 
389 377
 # Option 2:
390  
-# To rewrite "example.com -> www.example.com" uncomment the following lines.
391  
-# Be aware that the following rule might not be a good idea if you
392  
-# use "real" subdomains for certain parts of your website.
  378
+# Rewrite "example.com -> www.example.com".
  379
+# Be aware that the following rule might not be a good idea if you use "real"
  380
+# subdomains for certain parts of your website.
393 381
 
394 382
 # <IfModule mod_rewrite.c>
395 383
 #   RewriteCond %{HTTPS} !=on
@@ -398,7 +386,6 @@ FileETag None
398 386
 # </IfModule>
399 387
 
400 388
 
401  
-
402 389
 # ----------------------------------------------------------------------
403 390
 # Built-in filename-based cache busting
404 391
 # ----------------------------------------------------------------------
@@ -410,7 +397,6 @@ FileETag None
410 397
 # To understand why this is important and a better idea than all.css?v1231,
411 398
 # read: github.com/h5bp/html5-boilerplate/wiki/cachebusting
412 399
 
413  
-# Uncomment to enable.
414 400
 # <IfModule mod_rewrite.c>
415 401
 #   RewriteCond %{REQUEST_FILENAME} !-f
416 402
 #   RewriteCond %{REQUEST_FILENAME} !-d
@@ -418,14 +404,12 @@ FileETag None
418 404
 # </IfModule>
419 405
 
420 406
 
421  
-
422 407
 # ----------------------------------------------------------------------
423 408
 # Prevent SSL cert warnings
424 409
 # ----------------------------------------------------------------------
425 410
 
426 411
 # Rewrite secure requests properly to prevent SSL cert warnings, e.g. prevent
427 412
 # https://www.example.com when your cert only allows https://secure.example.com
428  
-# Uncomment the following lines to use this feature.
429 413
 
430 414
 # <IfModule mod_rewrite.c>
431 415
 #   RewriteCond %{SERVER_PORT} !^443
@@ -433,18 +417,17 @@ FileETag None
433 417
 # </IfModule>
434 418
 
435 419
 
436  
-
437 420
 # ----------------------------------------------------------------------
438 421
 # Prevent 404 errors for non-existing redirected folders
439 422
 # ----------------------------------------------------------------------
440 423
 
441  
-# without -MultiViews, Apache will give a 404 for a rewrite if a folder of the same name does not exist
442  
-#   e.g. /blog/hello : webmasterworld.com/apache/3808792.htm
  424
+# without -MultiViews, Apache will give a 404 for a rewrite if a folder of the
  425
+# same name does not exist.
  426
+# webmasterworld.com/apache/3808792.htm
443 427
 
444 428
 Options -MultiViews
445 429
 
446 430
 
447  
-
448 431
 # ----------------------------------------------------------------------
449 432
 # Custom 404 page
450 433
 # ----------------------------------------------------------------------
@@ -455,7 +438,6 @@ Options -MultiViews
455 438
 ErrorDocument 404 /404.html
456 439
 
457 440
 
458  
-
459 441
 # ----------------------------------------------------------------------
460 442
 # UTF-8 encoding
461 443
 # ----------------------------------------------------------------------
@@ -467,45 +449,40 @@ AddDefaultCharset utf-8
467 449
 AddCharset utf-8 .atom .css .js .json .rss .vtt .xml
468 450
 
469 451
 
470  
-
471 452
 # ----------------------------------------------------------------------
472 453
 # A little more security
473 454
 # ----------------------------------------------------------------------
474 455
 
475  
-
476  
-# Do we want to advertise the exact version number of Apache we're running?
477  
-# Probably not.
478  
-## This can only be enabled if used in httpd.conf - It will not work in .htaccess
  456
+# To avoid displaying the exact version number of Apache being used, add the
  457
+# following to httpd.conf (it will not work in .htaccess):
479 458
 # ServerTokens Prod
480 459
 
481  
-
482  
-# "-Indexes" will have Apache block users from browsing folders without a default document
483  
-# Usually you should leave this activated, because you shouldn't allow everybody to surf through
484  
-# every folder on your server (which includes rather private places like CMS system folders).
  460
+# "-Indexes" will have Apache block users from browsing folders without a
  461
+# default document Usually you should leave this activated, because you
  462
+# shouldn't allow everybody to surf through every folder on your server (which
  463
+# includes rather private places like CMS system folders).
485 464
 <IfModule mod_autoindex.c>
486 465
   Options -Indexes
487 466
 </IfModule>
488 467
 
489  
-
490  
-# Block access to "hidden" directories or files whose names begin with a period. This
491  
-# includes directories used by version control systems such as Subversion or Git.
  468
+# Block access to "hidden" directories or files whose names begin with a
  469
+# period. This includes directories used by version control systems such as
  470
+# Subversion or Git.
492 471
 <IfModule mod_rewrite.c>
493 472
   RewriteCond %{SCRIPT_FILENAME} -d [OR]
494 473
   RewriteCond %{SCRIPT_FILENAME} -f
495 474
   RewriteRule "(^|/)\." - [F]
496 475
 </IfModule>
497 476
 
498  
-
499  
-# Block access to backup and source files
500  
-# These files may be left by some text/html editors and
501  
-# pose a great security danger, when anyone can access them
  477
+# Block access to backup and source files. These files may be left by some
  478
+# text/html editors and pose a great security danger, when anyone can access
  479
+# them.
502 480
 <FilesMatch "(\.(bak|config|sql|fla|psd|ini|log|sh|inc|swp|dist)|~)$">
503 481
   Order allow,deny
504 482
   Deny from all
505 483
   Satisfy All
506 484
 </FilesMatch>
507 485
 
508  
-
509 486
 # If your server is not already configured as such, the following directive
510 487
 # should be uncommented in order to set PHP's register_globals option to OFF.
511 488
 # This closes a major security hole that is abused by most XSS (cross-site
17  crossdomain.xml
... ...
@@ -1,22 +1,15 @@
1 1
 <?xml version="1.0"?>
2 2
 <!DOCTYPE cross-domain-policy SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd">
3 3
 <cross-domain-policy>
  4
+    <!-- Read this: www.adobe.com/devnet/articles/crossdomain_policy_file_spec.html -->
4 5
 
5  
-<!-- Read this: www.adobe.com/devnet/articles/crossdomain_policy_file_spec.html -->
6  
-
7  
-<!-- Most restrictive policy: -->
  6
+    <!-- Most restrictive policy: -->
8 7
     <site-control permitted-cross-domain-policies="none"/>
9 8
 
10  
-<!-- Least restrictive policy: -->
11  
-<!--
  9
+    <!-- Least restrictive policy: -->
  10
+    <!--
12 11
     <site-control permitted-cross-domain-policies="all"/>
13 12
     <allow-access-from domain="*" to-ports="*" secure="false"/>
14 13
     <allow-http-request-headers-from domain="*" headers="*" secure="false"/>
15  
--->
16  
-<!--
17  
-  If you host a crossdomain.xml file with allow-access-from domain="*"
18  
-  and don’t understand all of the points described here, you probably
19  
-  have a nasty security vulnerability. ~ simon willison
20  
--->
21  
-
  14
+    -->
22 15
 </cross-domain-policy>
32  css/main.css
@@ -6,12 +6,10 @@
6 6
  * Kroc Camen, and the H5BP dev community and team.
7 7
  *
8 8
  * Detailed information about this CSS: h5bp.com/css
9  
- *
10  
- * ==|== normalize ==========================================================
11 9
  */
12 10
 
13 11
 
14  
-/* =============================================================================
  12
+/* ==========================================================================
15 13
    HTML5 display definitions
16 14
    ========================================================================== */
17 15
 
@@ -46,7 +44,7 @@ audio:not([controls]) {
46 44
 }
47 45
 
48 46
 
49  
-/* =============================================================================
  47
+/* ==========================================================================
50 48
    Base
51 49
    ========================================================================== */
52 50
 
@@ -93,7 +91,7 @@ body {
93 91
 }
94 92
 
95 93
 
96  
-/* =============================================================================
  94
+/* ==========================================================================
97 95
    Links
98 96
    ========================================================================== */
99 97
 
@@ -123,7 +121,7 @@ a:active {
123 121
 }
124 122
 
125 123
 
126  
-/* =============================================================================
  124
+/* ==========================================================================
127 125
    Typography
128 126
    ========================================================================== */
129 127
 
@@ -224,7 +222,7 @@ sub {
224 222
 }
225 223
 
226 224
 
227  
-/* =============================================================================
  225
+/* ==========================================================================
228 226
    Lists
229 227
    ========================================================================== */
230 228
 
@@ -247,7 +245,7 @@ nav ol {
247 245
 }
248 246
 
249 247
 
250  
-/* =============================================================================
  248
+/* ==========================================================================
251 249
    Embedded content
252 250
    ========================================================================== */
253 251
 
@@ -271,7 +269,7 @@ svg:not(:root) {
271 269
 }
272 270
 
273 271
 
274  
-/* =============================================================================
  272
+/* ==========================================================================
275 273
    Figures
276 274
    ========================================================================== */
277 275
 
@@ -280,7 +278,7 @@ figure {
280 278
 }
281 279
 
282 280
 
283  
-/* =============================================================================
  281
+/* ==========================================================================
284 282
    Forms
285 283
    ========================================================================== */
286 284
 
@@ -409,7 +407,7 @@ textarea {
409 407
 }
410 408
 
411 409
 
412  
-/* =============================================================================
  410
+/* ==========================================================================
413 411
    Tables
414 412
    ========================================================================== */
415 413
 
@@ -423,7 +421,7 @@ td {
423 421
 }
424 422
 
425 423
 
426  
-/* =============================================================================
  424
+/* ==========================================================================
427 425
    Chrome Frame Prompt
428 426
    ========================================================================== */
429 427
 
@@ -435,7 +433,8 @@ td {
435 433
 }
436 434
 
437 435
 
438  
-/* ==|== primary styles =====================================================
  436
+/* ==========================================================================
  437
+   Primary styles.
439 438
    Author:
440 439
    ========================================================================== */
441 440
 
@@ -454,7 +453,7 @@ td {
454 453
 
455 454
 
456 455
 
457  
-/* ==|== media queries ======================================================
  456
+/* ==========================================================================
458 457
    EXAMPLE Media Query for Responsive Design.
459 458
    This example overrides the primary ('mobile first') styles
460 459
    Modify as content requires.
@@ -466,7 +465,8 @@ td {
466 465
 
467 466
 
468 467
 
469  
-/* ==|== non-semantic helper classes ========================================
  468
+/* ==========================================================================
  469
+   Helper classes.
470 470
    Please define your styles before this section.
471 471
    ========================================================================== */
472 472
 
@@ -549,7 +549,7 @@ td {
549 549
 
550 550
 
551 551
 
552  
-/* ==|== print styles =======================================================
  552
+/* ==========================================================================
553 553
    Print styles.
554 554
    Inlined to avoid required HTTP connection: h5bp.com/r
555 555
    ========================================================================== */
29  humans.txt
... ...
@@ -1,6 +1,5 @@
  1
+# humanstxt.org/
1 2
 # The humans responsible & technology colophon
2  
-# humanstxt.org
3  
-
4 3
 
5 4
 # TEAM
6 5
 
@@ -14,29 +13,3 @@
14 13
 
15 14
     HTML5, CSS3
16 15
     jQuery, Modernizr
17  
-
18  
-
19  
-
20  
-                               -o/-
21  
-                               +oo//-
22  
-                              :ooo+//:
23  
-                             -ooooo///-
24  
-                             /oooooo//:
25  
-                            :ooooooo+//-
26  
-                           -+oooooooo///-
27  
-           -://////////////+oooooooooo++////////////::
28  
-            :+ooooooooooooooooooooooooooooooooooooo+:::-
29  
-              -/+ooooooooooooooooooooooooooooooo+/::////:-
30  
-                -:+oooooooooooooooooooooooooooo/::///////:-
31  
-                  --/+ooooooooooooooooooooo+::://////:-
32  
-                     -:+ooooooooooooooooo+:://////:--
33  
-                       /ooooooooooooooooo+//////:-
34  
-                      -ooooooooooooooooooo////-
35  
-                      /ooooooooo+oooooooooo//:
36  
-                     :ooooooo+/::/+oooooooo+//-
37  
-                    -oooooo/::///////+oooooo///-
38  
-                    /ooo+::://////:---:/+oooo//:
39  
-                   -o+/::///////:-      -:/+o+//-
40  
-                   :-:///////:-            -:/://
41  
-                     -////:-                 --//:
42  
-                       --                       -:
36  index.html
... ...
@@ -1,55 +1,33 @@
1 1
 <!DOCTYPE html>
2  
-<!-- paulirish.com/2008/conditional-stylesheets-vs-css-hacks-answer-neither/ -->
3  
-<!-- Consider specifying the language of your content by adding the `lang` attribute to <html> -->
4  
-<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
5  
-<!--[if IE 7]>    <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
6  
-<!--[if IE 8]>    <html class="no-js lt-ie9"> <![endif]-->
  2
+<!--[if lt IE 7]>      <html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
  3
+<!--[if IE 7]>         <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
  4
+<!--[if IE 8]>         <html class="no-js lt-ie9"> <![endif]-->
7 5
 <!--[if gt IE 8]><!--> <html class="no-js"> <!--<![endif]-->
8 6
 <head>
9 7
     <meta charset="utf-8">
10  
-
11  
-    <!-- Use the .htaccess and remove these lines to avoid edge case issues.
12  
-         More info: h5bp.com/i/378 -->
13 8
     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
14  
-
15 9
     <title></title>
16 10
     <meta name="description" content="">
17  
-
18  
-    <!-- Mobile viewport optimized: h5bp.com/viewport -->
19 11
     <meta name="viewport" content="width=device-width">
20 12
 
21 13
     <!-- Place favicon.ico and apple-touch-icon.png in the root directory: mathiasbynens.be/notes/touch-icons -->
22 14
 
23 15
     <link rel="stylesheet" href="css/main.css">
24  
-
25  
-    <!-- More ideas for your <head> here: h5bp.com/d/head-Tips -->
26  
-
27  
-    <!-- All JavaScript at the bottom, except this Modernizr build.
28  
-         Modernizr enables HTML5 elements & feature detects for optimal performance.
29  
-         Create your own custom Modernizr build: www.modernizr.com/download/ -->
30 16
     <script src="js/vendor/modernizr-2.6.1.min.js"></script>
31 17
 </head>
32 18
 <body>
33  
-    <!-- Prompt IE 6 users to install Chrome Frame. Remove this if you support IE 6.
34  
-         chromium.org/developers/how-tos/chrome-frame-getting-started -->
35  
-    <!--[if lt IE 7]><p class="chromeframe">Your browser is <em>ancient!</em> <a href="http://browsehappy.com/">Upgrade to a different browser</a> or <a href="http://www.google.com/chromeframe/?redirect=true">install Google Chrome Frame</a> to experience this site.</p><![endif]-->
  19
+    <!--[if lt IE 7]>
  20
+        <p class="chromeframe">You are using an outdated browser. <a href="http://browsehappy.com/">Upgrade your browser today</a> or <a href="http://www.google.com/chromeframe/?redirect=true">install Google Chrome Frame</a> to better experience this site.</p>
  21
+    <![endif]-->
36 22
 
37 23
     <!-- Add your site or application content here -->
38 24
 
39  
-
40  
-    <!-- JavaScript at the bottom for fast page loading: http://developer.yahoo.com/performance/rules.html#js_bottom -->
41  
-
42  
-    <!-- Grab Google CDN's jQuery, with a protocol relative URL; fall back to local if offline -->
43 25
     <script src="//ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
44 26
     <script>window.jQuery || document.write('<script src="js/vendor/jquery-1.7.2.min.js"><\/script>')</script>
45  
-
46  
-    <!-- scripts concatenated and minified via build script -->
47 27
     <script src="js/plugins.js"></script>
48 28
     <script src="js/main.js"></script>
49  
-    <!-- end scripts -->
50 29
 
51  
-    <!-- Asynchronous Google Analytics snippet. Change UA-XXXXX-X to be your site's ID.
52  
-         mathiasbynens.be/notes/async-analytics-snippet -->
  30
+    <!-- Google Analytics: change UA-XXXXX-X to be your site's ID. -->
53 31
     <script>
54 32
         var _gaq=[['_setAccount','UA-XXXXX-X'],['_trackPageview']];
55 33
         (function(d,t){var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
2  js/main.js
... ...
@@ -1,3 +1 @@
1  
-/* Author:
2 1
 
3  
-*/
4  js/plugins.js
... ...
@@ -1,4 +1,4 @@
1  
-// Avoid `console` errors in browsers that lack a console
  1
+// Avoid `console` errors in browsers that lack a console.
2 2
 if (!(window.console && console.log)) {
3 3
     (function() {
4 4
         var noop = function() {};
@@ -11,4 +11,4 @@ if (!(window.console && console.log)) {
11 11
     }());
12 12
 }
13 13
 
14  
-// place any jQuery/helper plugins in here, instead of separate, slower script files.
  14
+// Place any jQuery/helper plugins in here.
3  robots.txt
... ...
@@ -1,4 +1,3 @@
1  
-# www.robotstxt.org/
2  
-# https://developers.google.com/webmasters/control-crawl-index/
  1
+# robotstxt.org/
3 2
 
4 3
 User-agent: *

5 notes on commit 889e377

d8uv

This commit broke drop-in h5bp/ant-build-script

Nicolas Gallagher
Owner

That's an issue for the ant-build-script and has been raised here before. This project isn't going to leave pieces of code lying around just in case someone wants to use a build script that requires them. Most people don't use the build scripts. If you use the build script, then adding some HTML comments is a fairly minor step in the process of configuring it.

d8uv

I'm not disagreeing, I'd rather have a clean h5bp than one littered with comments. I just wanted to comment in case it was a slip. (I lost 15 minutes on finding out why the build script stopped working, so... when this deadline stops looming, I'll see if I can help out the docs)

Thank you!

Nicolas Gallagher
Owner

No worries. If you want to help out, and the ant-build-script docs are not clear or up to date, please do feel free to improve that project's docs. It would be much appreciated! :)

Irae Carvalho

Some of this lines are very constructive and one of the strengths of H5BP. I agree with most of this commit, but this one in particular and some others should stay as it avoids people reopening issues and improve awareness on why some of this came to be in the project.

I constantly point people to H5BP to learn front-end best practices, but some of the removals may hide this value that the project currently has.

Nicolas Gallagher

You can point them to the bundled docs instead.

d8uv

h5bp/ant-build-script@be424f7 solved my only complaint with this commit, so thanks! I love you all <3

Please sign in to comment.
Something went wrong with that request. Please try again.