Merge remote-tracking branch 'origin/master'

Author: aFarkas

README.md

@@ -1,6 +1,6 @@
 # Picturefill
 A [responsive image](http://www.whatwg.org/specs/web-apps/current-work/multipage/embedded-content.html#embedded-content) polyfill.
-* Authors: See [Authors.txt](https://github.com/scottjehl/picturefill/blob/3.0/Authors.txt)
+* Authors: See [Authors.txt](https://raw.githubusercontent.com/scottjehl/picturefill/master/Authors.txt)
 * License: MIT
 
 [![build-status](https://api.travis-ci.org/scottjehl/picturefill.svg)](https://travis-ci.org/scottjehl/picturefill) [<img src="https://pf-slackin.herokuapp.com/badge.svg" alt="Join Slack channel">](https://pf-slackin.herokuapp.com/)
@@ -15,9 +15,9 @@ Picturefill has three versions:
 To find out how to use Picturefill, visit the [project site](http://scottjehl.github.com/picturefill/).
 
 ## The gotchas
-Be it browsers, the `picture` spec, or picturefill, there are a couple gotchas you should be aware of when working with Picturefill.
+Be it browser issues, the responsive images specifications, or Picturefill itself, there are a couple gotchas you should be aware of when working with Picturefill:
 
-- Firefox 38 and 39 has some bugs [[1]](https://bugzilla.mozilla.org/show_bug.cgi?id=1139560) [[2]](https://bugzilla.mozilla.org/show_bug.cgi?id=1139554) [[3]](https://bugzilla.mozilla.org/show_bug.cgi?id=1135812) where images won't update on screen resize. These should be fixed in Firefox 40.
+- Firefox 38 and 39 has some bugs [[1]](https://bugzilla.mozilla.org/show_bug.cgi?id=1139560) [[2]](https://bugzilla.mozilla.org/show_bug.cgi?id=1139554) [[3]](https://bugzilla.mozilla.org/show_bug.cgi?id=1135812) where images won't update on screen resize. These issues are addressed by Picturefill 3.0.0, and should be fixed in Firefox 41.
 
 - Per the `picture` spec, using `%` _isn't_ allowed in the `sizes` attribute. Using `%` will fallback to `100vw`.
 

bower.json

@@ -1,7 +1,7 @@
 {
 	"name": "picturefill",
 	"repo": "scottjehl/picturefill",
-	"description": "A Polyfill for the HTML Picture Element (http://picture.responsiveimages.org/) that you can use today.",
+	"description": "A polyfill for responsive images (http://picture.responsiveimages.org/) that you can use today.",
 	"main": "dist/picturefill.js",
 	"scripts": [
 		"dist/picturefill.js"

examples/styles.css

@@ -91,6 +91,10 @@ main {
     letter-spacing: .125em;
     text-rendering: optimizeLegibility;
 }
+.hed-currentversion {
+    font-size: 1.35em;
+    letter-spacing: .09em;
+}
 .lede .hed-subsection {
     font-size: .9em;
 }

index.html

@@ -35,7 +35,7 @@ <h1 class="hed">Picturefill</h1>
 			<div class="lede">
 				<p>The <a href="http://picture.responsiveimages.org/"><code>picture</code> element, <code>srcset</code> and <code>sizes</code> attributes</a>, and associated features allow web developers to deliver an appropriate image to every user depending on a variety of conditions like screen size, viewport size, screen resolution, and more. Picturefill enables support for the <code>picture</code> element and associated features in browsers that do not yet support them, so you can start using them today!</p>
 
-				<p>Picturefill development is sponsored by <a href="http://filamentgroup.com"><img src="logos/fg-sm.png" class="filament-logo inline-logo" alt="Filament Group"></a> and <a href="http://bocoup.com"><img src="logos/bocoup-sm.png" class="bocoup-logo inline-logo" alt="Bocoup"></a>, and maintained by the <a href="https://github.com/scottjehl/picturefill/blob/master/Authors.txt">Picturefill Team</a>.</p>
+				<p>Picturefill development is sponsored by <a href="http://filamentgroup.com"><img src="logos/fg-sm.png" class="filament-logo inline-logo" alt="Filament Group"></a> and <a href="http://bocoup.com"><img src="logos/bocoup-sm.png" class="bocoup-logo inline-logo" alt="Bocoup"></a>, and maintained by the <a href="https://github.com/scottjehl/picturefill/blob/master/Authors.txt">Picturefill Team</a>. Ongoing discussion of the project is conducted via <a href="https://pf-slackin.herokuapp.com/">Slack</a>.</p>
 
 				<h3 class="hed-subsection" id="contributing">Contributing, Bug Reports, and More information</h3>
 
@@ -45,11 +45,11 @@ <h3 class="hed-subsection" id="contributing">Contributing, Bug Reports, and More
 
 			<h2 class="hed-section" id="download">Downloading Picturefill</h2>
 
-			<h3 class="hed-subsection">Picturefill Version 3.0.0 (Release Candidate 1)</h3>
+			<h3 class="hed-subsection hed-currentversion">Picturefill Version 3.0.0 (Stable)</h3>
 
 			<p>Version 3 is a <em>full rewrite</em> of the Picturefill codebase, featuring optimized performance, better emulation of native behavior, and parsers that adhere much more closely to <a href="http://picture.responsiveimages.org">the specification</a>. It also handles many of the quirks, shortcomings, and edge cases related to first-generation native implementations.</p>
 
-			<p>Feedback on this beta release is highly welcomed—if you encounter any problems, please <a href="https://github.com/scottjehl/picturefill/issues">file an issue on GitHub</a>.</p>
+			<p>Feedback on this release is highly welcomed—if you encounter any problems, please <a href="https://github.com/scottjehl/picturefill/issues">file an issue on GitHub</a>.</p>
 			<ul>
 				<li>
 					<a href="https://cdn.rawgit.com/scottjehl/picturefill/3.0/dist/picturefill.js" class="download">picturefill.js</a>
@@ -61,8 +61,8 @@ <h3 class="hed-subsection">Picturefill Version 3.0.0 (Release Candidate 1)</h3>
 				</li>
 			</ul>
 
-			<h3 class="hed-subsection">Picturefill Version 2.3.1 (Stable)</h3>
-			<p>This is the old way, and it's still available. Please note however that <a href="https://css-tricks.com/please-update-picturefill/">because of a recently-fixed bug</a>, you should absolutely not be using any version of Picturefill prior to 2.3.1. If you are, please update immediately. These downloads include the <a href="https://github.com/paulirish/matchMedia.js/">matchMedia polyfill</a> for browsers that need it (like IE9).</p>
+			<h3 class="hed-subsection">Picturefill Version 2.3.1</h3>
+			<p>Picturefill 2 is a lightweight polyfill that may not perfectly match native responsive images behavior. Please note however that <a href="https://css-tricks.com/please-update-picturefill/">because of a recently-fixed bug</a>, you should absolutely not be using any version of Picturefill prior to 2.3.1. If you are, please update immediately. These downloads include the <a href="https://github.com/paulirish/matchMedia.js/">matchMedia polyfill</a> for browsers that need it (like IE9).</p>
 			<ul>
 				<li>
 					<a class="download" href="https://github.com/scottjehl/picturefill/blob/2.3.1/dist/picturefill.js">picturefill.js</a>

picturefill.json

@@ -1,7 +1,7 @@
 {
 	"name": "Picturefill",
 	"title": "Picturefill",
-	"description": "A Polyfill for the HTML Picture Element (http://picture.responsiveimages.org/) that you can use today.",
+	"description": "A polyfill for responsive images (http://picture.responsiveimages.org/) that you can use today.",
 	"version": "3.0.0",
 	"homepage": "http://scottjehl.github.io/picturefill",
 	"author": {