From 889e377b2d20eaaa690785d7e47daf50aa46b972 Mon Sep 17 00:00:00 2001 From: Nicolas Gallagher Date: Sun, 29 Jul 2012 14:48:14 +0100 Subject: [PATCH] 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 --- .htaccess | 115 +++++++++++++++++++----------------------------- crossdomain.xml | 17 +++---- css/main.css | 32 +++++++------- humans.txt | 29 +----------- index.html | 36 +++------------ js/main.js | 2 - js/plugins.js | 4 +- robots.txt | 3 +- 8 files changed, 78 insertions(+), 160 deletions(-) diff --git a/.htaccess b/.htaccess index eb7f1870b9..726751dcb8 100644 --- a/.htaccess +++ b/.htaccess @@ -1,8 +1,8 @@ # Apache configuration file # httpd.apache.org/docs/2.2/mod/quickreference.html -# Note .htaccess files are an overhead, this logic should be in your Apache config if possible -# httpd.apache.org/docs/2.2/howto/htaccess.html +# Note .htaccess files are an overhead, this logic should be in your Apache +# config if possible: httpd.apache.org/docs/2.2/howto/htaccess.html # Techniques in here adapted from all over, including: # Kroc Camen: camendesign.com/.htaccess @@ -10,13 +10,6 @@ # Sample .htaccess file of CMS MODx: modxcms.com -### -### If you run a webserver other than Apache, consider: -### github.com/h5bp/server-configs -### - - - # ---------------------------------------------------------------------- # Better website experience for IE users # ---------------------------------------------------------------------- @@ -83,12 +76,10 @@ - # ---------------------------------------------------------------------- # Proper MIME type for all files # ---------------------------------------------------------------------- - # JavaScript # Normalize to standard type (it's sniffed in IE anyways) # tools.ietf.org/html/rfc4329#section-7.2 @@ -143,15 +134,14 @@ AddType text/vtt vtt # and they would be included into this single file. # This is not in use in the boilerplate as it stands. You may -# choose to name your files in this way for this advantage or -# concatenate and minify them manually. -# Disabled by default. +# choose to use this technique if you do not have a build process. # # Options +Includes # AddOutputFilterByType INCLUDES application/javascript application/json # SetOutputFilter INCLUDES # + # # Options +Includes # AddOutputFilterByType INCLUDES text/css @@ -217,8 +207,8 @@ AddType text/vtt vtt # Additionally, consider that outdated proxies may miscache # www.stevesouders.com/blog/2008/08/23/revving-filenames-dont-use-querystring/ -# If you don't use filenames to version, lower the CSS and JS to something like -# "access plus 1 week" or so. +# If you don't use filenames to version, lower the CSS and JS to something like +# "access plus 1 week". ExpiresActive on @@ -269,19 +259,20 @@ AddType text/vtt vtt + # ---------------------------------------------------------------------- # Prevent mobile network providers from modifying your site # ---------------------------------------------------------------------- -# The following header prevents modification of your code over 3G on some European providers -# This is the official 'bypass' suggested by O2 in the UK +# The following header prevents modification of your code over 3G on some +# European providers. +# This is the official 'bypass' suggested by O2 in the UK. # # Header set Cache-Control "no-transform" # - # ---------------------------------------------------------------------- # ETag removal # ---------------------------------------------------------------------- @@ -297,14 +288,12 @@ AddType text/vtt vtt FileETag None - # ---------------------------------------------------------------------- # Stop screen flicker in IE on CSS rollovers # ---------------------------------------------------------------------- # The following directives stop screen flicker in IE on CSS rollovers - in -# combination with the "ExpiresByType" rules for images (see above). If -# needed, un-comment the following rules. +# combination with the "ExpiresByType" rules for images (see above). # BrowserMatch "MSIE" brokenvary=1 # BrowserMatch "Mozilla/4.[0-9]{2}" brokenvary=1 @@ -312,43 +301,41 @@ FileETag None # SetEnvIf brokenvary 1 force-no-vary - # ---------------------------------------------------------------------- # Set Keep-Alive Header # ---------------------------------------------------------------------- -# Keep-Alive allows the server to send multiple requests through one TCP-connection. -# Be aware of possible disadvantages of this setting. Turn on if you serve a lot of -# static content. +# Keep-Alive allows the server to send multiple requests through one +# TCP-connection. Be aware of possible disadvantages of this setting. Turn on +# if you serve a lot of static content. # # Header set Connection Keep-Alive # - # ---------------------------------------------------------------------- # Cookie setting from iframes # ---------------------------------------------------------------------- # Allow cookies to be set from iframes (for IE only) -# If needed, uncomment and specify a path or regex in the Location directive +# If needed, specify a path or regex in the Location directive. # # Header set P3P "policyref=\"/w3c/p3p.xml\", CP=\"IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT\"" # - # ---------------------------------------------------------------------- # Start rewrite engine # ---------------------------------------------------------------------- -# Turning on the rewrite engine is necessary for the following rules and features. -# FollowSymLinks must be enabled for this to work. +# Turning on the rewrite engine is necessary for the following rules and +# features. FollowSymLinks must be enabled for this to work. # -# Some cloud hosting services require RewriteBase to be set: goo.gl/HOcPN -# If using the h5bp in a subdirectory, use `RewriteBase /foo` instead where 'foo' is your directory. +# Some cloud hosting services require RewriteBase to be set: goo.gl/HOcPN If +# using the h5bp in a subdirectory, use `RewriteBase /foo` instead where 'foo' +# is your directory. Options +FollowSymlinks @@ -357,26 +344,27 @@ FileETag None - # ---------------------------------------------------------------------- # Suppress or force the "www." at the beginning of URLs # ---------------------------------------------------------------------- -# The same content should never be available under two different URLs - especially not with and -# without "www." at the beginning, since this can cause SEO problems (duplicate content). -# That's why you should choose one of the alternatives and redirect the other one. +# The same content should never be available under two different URLs - +# especially not with and without "www." at the beginning, since this can cause +# SEO problems (duplicate content). That's why you should choose one of the +# alternatives and redirect the other one. -# By default option 1 (no "www.") is activated. Remember: Shorter URLs are sexier. +# By default option 1 (no "www.") is activated. # no-www.org/faq.php?q=class_b -# If you rather want to use option 2, just comment out all option 1 lines +# If you'd prefer to use option 2, just comment out all option 1 lines # and uncomment option 2. + # IMPORTANT: NEVER USE BOTH RULES AT THE SAME TIME! # ---------------------------------------------------------------------- # Option 1: -# Rewrite "www.example.com -> example.com" +# Rewrite "www.example.com -> example.com". RewriteCond %{HTTPS} !=on @@ -387,9 +375,9 @@ FileETag None # ---------------------------------------------------------------------- # Option 2: -# To rewrite "example.com -> www.example.com" uncomment the following lines. -# Be aware that the following rule might not be a good idea if you -# use "real" subdomains for certain parts of your website. +# Rewrite "example.com -> www.example.com". +# Be aware that the following rule might not be a good idea if you use "real" +# subdomains for certain parts of your website. # # RewriteCond %{HTTPS} !=on @@ -398,7 +386,6 @@ FileETag None # - # ---------------------------------------------------------------------- # Built-in filename-based cache busting # ---------------------------------------------------------------------- @@ -410,7 +397,6 @@ FileETag None # To understand why this is important and a better idea than all.css?v1231, # read: github.com/h5bp/html5-boilerplate/wiki/cachebusting -# Uncomment to enable. # # RewriteCond %{REQUEST_FILENAME} !-f # RewriteCond %{REQUEST_FILENAME} !-d @@ -418,14 +404,12 @@ FileETag None # - # ---------------------------------------------------------------------- # Prevent SSL cert warnings # ---------------------------------------------------------------------- # Rewrite secure requests properly to prevent SSL cert warnings, e.g. prevent # https://www.example.com when your cert only allows https://secure.example.com -# Uncomment the following lines to use this feature. # # RewriteCond %{SERVER_PORT} !^443 @@ -433,18 +417,17 @@ FileETag None # - # ---------------------------------------------------------------------- # Prevent 404 errors for non-existing redirected folders # ---------------------------------------------------------------------- -# without -MultiViews, Apache will give a 404 for a rewrite if a folder of the same name does not exist -# e.g. /blog/hello : webmasterworld.com/apache/3808792.htm +# without -MultiViews, Apache will give a 404 for a rewrite if a folder of the +# same name does not exist. +# webmasterworld.com/apache/3808792.htm Options -MultiViews - # ---------------------------------------------------------------------- # Custom 404 page # ---------------------------------------------------------------------- @@ -455,7 +438,6 @@ Options -MultiViews ErrorDocument 404 /404.html - # ---------------------------------------------------------------------- # UTF-8 encoding # ---------------------------------------------------------------------- @@ -467,45 +449,40 @@ AddDefaultCharset utf-8 AddCharset utf-8 .atom .css .js .json .rss .vtt .xml - # ---------------------------------------------------------------------- # A little more security # ---------------------------------------------------------------------- - -# Do we want to advertise the exact version number of Apache we're running? -# Probably not. -## This can only be enabled if used in httpd.conf - It will not work in .htaccess +# To avoid displaying the exact version number of Apache being used, add the +# following to httpd.conf (it will not work in .htaccess): # ServerTokens Prod - -# "-Indexes" will have Apache block users from browsing folders without a default document -# Usually you should leave this activated, because you shouldn't allow everybody to surf through -# every folder on your server (which includes rather private places like CMS system folders). +# "-Indexes" will have Apache block users from browsing folders without a +# default document Usually you should leave this activated, because you +# shouldn't allow everybody to surf through every folder on your server (which +# includes rather private places like CMS system folders). Options -Indexes - -# Block access to "hidden" directories or files whose names begin with a period. This -# includes directories used by version control systems such as Subversion or Git. +# Block access to "hidden" directories or files whose names begin with a +# period. This includes directories used by version control systems such as +# Subversion or Git. RewriteCond %{SCRIPT_FILENAME} -d [OR] RewriteCond %{SCRIPT_FILENAME} -f RewriteRule "(^|/)\." - [F] - -# Block access to backup and source files -# These files may be left by some text/html editors and -# pose a great security danger, when anyone can access them +# Block access to backup and source files. These files may be left by some +# text/html editors and pose a great security danger, when anyone can access +# them. Order allow,deny Deny from all Satisfy All - # If your server is not already configured as such, the following directive # should be uncommented in order to set PHP's register_globals option to OFF. # This closes a major security hole that is abused by most XSS (cross-site diff --git a/crossdomain.xml b/crossdomain.xml index 549ab9a18c..29a035d7fc 100644 --- a/crossdomain.xml +++ b/crossdomain.xml @@ -1,22 +1,15 @@ + - - - + - - + - - + --> diff --git a/css/main.css b/css/main.css index 4268235ee2..a6a389219f 100644 --- a/css/main.css +++ b/css/main.css @@ -6,12 +6,10 @@ * Kroc Camen, and the H5BP dev community and team. * * Detailed information about this CSS: h5bp.com/css - * - * ==|== normalize ========================================================== */ -/* ============================================================================= +/* ========================================================================== HTML5 display definitions ========================================================================== */ @@ -46,7 +44,7 @@ audio:not([controls]) { } -/* ============================================================================= +/* ========================================================================== Base ========================================================================== */ @@ -93,7 +91,7 @@ body { } -/* ============================================================================= +/* ========================================================================== Links ========================================================================== */ @@ -123,7 +121,7 @@ a:active { } -/* ============================================================================= +/* ========================================================================== Typography ========================================================================== */ @@ -224,7 +222,7 @@ sub { } -/* ============================================================================= +/* ========================================================================== Lists ========================================================================== */ @@ -247,7 +245,7 @@ nav ol { } -/* ============================================================================= +/* ========================================================================== Embedded content ========================================================================== */ @@ -271,7 +269,7 @@ svg:not(:root) { } -/* ============================================================================= +/* ========================================================================== Figures ========================================================================== */ @@ -280,7 +278,7 @@ figure { } -/* ============================================================================= +/* ========================================================================== Forms ========================================================================== */ @@ -409,7 +407,7 @@ textarea { } -/* ============================================================================= +/* ========================================================================== Tables ========================================================================== */ @@ -423,7 +421,7 @@ td { } -/* ============================================================================= +/* ========================================================================== Chrome Frame Prompt ========================================================================== */ @@ -435,7 +433,8 @@ td { } -/* ==|== primary styles ===================================================== +/* ========================================================================== + Primary styles. Author: ========================================================================== */ @@ -454,7 +453,7 @@ td { -/* ==|== media queries ====================================================== +/* ========================================================================== EXAMPLE Media Query for Responsive Design. This example overrides the primary ('mobile first') styles Modify as content requires. @@ -466,7 +465,8 @@ td { -/* ==|== non-semantic helper classes ======================================== +/* ========================================================================== + Helper classes. Please define your styles before this section. ========================================================================== */ @@ -549,7 +549,7 @@ td { -/* ==|== print styles ======================================================= +/* ========================================================================== Print styles. Inlined to avoid required HTTP connection: h5bp.com/r ========================================================================== */ diff --git a/humans.txt b/humans.txt index a3e535fbdf..5b037cf2e1 100644 --- a/humans.txt +++ b/humans.txt @@ -1,6 +1,5 @@ +# humanstxt.org/ # The humans responsible & technology colophon -# humanstxt.org - # TEAM @@ -14,29 +13,3 @@ HTML5, CSS3 jQuery, Modernizr - - - - -o/- - +oo//- - :ooo+//: - -ooooo///- - /oooooo//: - :ooooooo+//- - -+oooooooo///- - -://////////////+oooooooooo++////////////:: - :+ooooooooooooooooooooooooooooooooooooo+:::- - -/+ooooooooooooooooooooooooooooooo+/::////:- - -:+oooooooooooooooooooooooooooo/::///////:- - --/+ooooooooooooooooooooo+::://////:- - -:+ooooooooooooooooo+:://////:-- - /ooooooooooooooooo+//////:- - -ooooooooooooooooooo////- - /ooooooooo+oooooooooo//: - :ooooooo+/::/+oooooooo+//- - -oooooo/::///////+oooooo///- - /ooo+::://////:---:/+oooo//: - -o+/::///////:- -:/+o+//- - :-:///////:- -:/:// - -////:- --//: - -- -: diff --git a/index.html b/index.html index c4891902d7..5923f29eb5 100644 --- a/index.html +++ b/index.html @@ -1,55 +1,33 @@ - - - - - + + + - - - - - - - - - - - + - - - - - - - - +