Merge pull request #531 from baloneysandwiches/docsplanation

summarize 3.0 alpha features

Author: Alexander Farkas

index.html

@@ -45,8 +45,8 @@ <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 Alpha</h3>
-			<p>For native <code>picture</code> element support, you'll want Picturefill version 2. 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 3.0.0 (Alpha)</h3>
+			<p>Version 3 is a full rewrite of the codebase featuring optimized performance, better emulation of native behavior, and new spec-based parsers. It also handles some of the quirks, shortcomings, and edge cases related to first-generation native implementations. For IE 9 and earlier, version 3 includes a small shim that polyfills the use of common media conditions (<code>min-width</code>, <code>max-width</code>, <code>min-height</code>, <code>max-height</code>). If you need old IE support for other media conditions, such as <code>orientation</code> or <code>aspect-ratio</code>, please additionally include the <a href="https://github.com/paulirish/matchMedia.js/">matchMedia polyfill</a>. Feedback on this alpha release is welcome. If you encounter problems, please <a href="https://github.com/scottjehl/picturefill/issues">file a issue</a> on Github.</p>
 			<ul>
 				<li>
 					<a href="#" class="download">picturefill.js</a>
@@ -58,15 +58,15 @@ <h3 class="hed-subsection">Picturefill Version 3.0.0 Alpha</h3>
 				</li>
 			</ul>
 
-			<h3 class="hed-subsection">Picturefill Version 2.2.0</h3>
-			<p>For native <code>picture</code> element support, you'll want Picturefill version 2. 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 (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>
 			<ul>
 				<li>
-					<a class="download" href="https://github.com/scottjehl/picturefill/blob/2.2.0/dist/picturefill.js">picturefill.js</a>
+					<a class="download" href="https://github.com/scottjehl/picturefill/blob/2.3.1/dist/picturefill.js">picturefill.js</a>
 					<p class="meta">(development version, unminified code)</p>
 				</li>
 				<li>
-					<a class="download" href="https://github.com/scottjehl/picturefill/blob/2.2.0/dist/picturefill.min.js">picturefill.min.js</a>
+					<a class="download" href="https://github.com/scottjehl/picturefill/blob/2.3.1/dist/picturefill.min.js">picturefill.min.js</a>
 					<p class="meta">(production version, minified code)</p>
 				</li>
 			</ul>