Merge pull request #26 from mindsize/master

Update Version section of Introduction for readability and utility

Author: claudiosanches

source/includes/v3/_introduction.md

@@ -22,6 +22,18 @@ The current API version is `v3` which takes a first-order position in endpoints.
 
 The `v1` and `v2` APIs will be removed in future versions.
 
+### What's changed in v3? ###
+
+* v3 implements full basic authentication ([conforms to the Basic auth spec)](http://tools.ietf.org/html/rfc2617)).
+* v3 fixes the OAuth implementation to be compliant with the [Oauth 1.0a specs](http://tools.ietf.org/html/rfc5849).
+* v3 includes a new endpoint to [get all product orders](#view-list-of-product-orders).
+* v3 has new endpoints for bulk creation and updating of [products](#create-update-multiple-products), [orders](#create-update-multiple-orders), [customers](#create-update-multiple-customers) and [coupons](#create-update-multiple-coupons).
+* v3 introduces new [product attribute endpoints](#product-attributes) (`GET`, `POST`, `PUT` and `DELETE`).
+* v3 deprecated the product/sku/<id> endpoint (because a SKU can be generated with any character and there is a filter, `filter[sku]`, that covers this use case).
+* v3 includes category thumbnails with requests for `product/categories`.
+* v3 can auto generate passwords for new customers if the "automatically generate customer password" option is enabled.
+
+
 ### Differences between v1 and v2 ###
 
 * v1 supports XML response format, v2 only supports JSON.
@@ -33,17 +45,6 @@ The `v1` and `v2` APIs will be removed in future versions.
 * v1 does not include any endpoints for getting valid order statuses, v2 includes an endpoint for listing valid order statuses (`GET /orders/statuses`).
 * v2 supports the core features added in WooCommerce 2.2, primarily order refunds (via the `/orders/refunds` endpoint) and Webhooks (via the `/webhooks`).
 
-### Differences between v3 and older versions ###
-
-* v3 implements full basic authentication ([conforms to the Basic auth spec)](http://tools.ietf.org/html/rfc2617)).
-* v3 fixes the OAuth implementation to be compliant with the [Oauth 1.0a specs](http://tools.ietf.org/html/rfc5849).
-* v3 includes a new endpoint to get all product orders.
-* v3 has new endpoints to allow bulk actions as edition and creation of products, orders, customers and coupons.
-* v3 introduces new product attribute endpoints (`GET`, `POST`, `PUT` and `DELETE`).
-* v3 deprecated the product/sku/<id> endpoint (because a SKU can be generated with any character, besides that there is a filter callend `filter[sku]`).
-* v3 includes category thumbnails on the requests for `product/categories`.
-* v3 uses our option to auto generate passwords for new customers.
-
 ### API Docs for past versions ###
 
 * [WooCommerce REST API v1 docs](v1.html)