Update documentation format for Middleman docs site

guides/source/users/products/product-properties.html.md

@@ -4,8 +4,8 @@ Product properties track individual attributes for a product, especially if the
 attributes only apply to one specific product. Typically, product properties
 would be used for technical specifications or additional production information. 
 
-For example, you can list of product properties for a limited edition t-shirt as
-a table on its product page:
+For example, you can see a list of product properties for a limited edition
+t-shirt as a table on its product page:
 
 | Property name | Property value   |
 |---------------|------------------|

guides/source/users/products/variants.html.md

@@ -0,0 +1,39 @@
+# Variants
+
+A product can have many variants. For example, you may sell a t-shirt that comes
+in two colors and three sizes.
+
+## Variants are customer-selectable product options
+
+The customer can choose any variant of a product from the storefront.
+
+In our t-shirt example, the product has six variants that customers can pick:
+
+| Variant | Color    | Size      |
+|---------|----------|-----------|
+| 1       | Red      | Small     |
+| 2       |          | Medium    |
+| 3       |          | Large     |
+| 4       | Green    | Small     |
+| 5       |          | Medium    |
+| 6       |          | Large     |
+
+You can create [option types and option values][option-types] for any variant
+that you want to create. In addition to **Size** and **Color**, you may want to
+offer **Material**, **Quantity**, or other option types.
+
+[option-types]: option-types.html
+
+## Change product details
+
+Variants can be more complex than this. While they use the [product
+details][product-details] from the product they belong to, you can change the
+following information about any variant:
+
+- **SKU**
+- Dimensions (**Weight**, **Height**, **Width**, and **Depth**)
+- **Price**
+- **Cost Price**
+- **Tax Category**
+
+[product-details]: product-details.html