Clarify documentation about upgrades/downgrades between same vs. diff…

…erent product families
chargify · Mar 5, 2012 · 0e6e5f6 · 0e6e5f6
1 parent 23ee569
commit 0e6e5f6
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 1 deletion.
diff --git a/doculab/docs/product-families.textile b/doculab/docs/product-families.textile
@@ -2,6 +2,10 @@ h3. What is a Product Family?
 
 *Product Families* provide a grouping for your Products that can be considered different "feature levels" or "plans" of the same service or offering.  If you're building a web app with different plans, in general, a Product Family will represent your app, and Products will represent your plans.  We've just generalized the terminology to apply to more situations.
 
+Your customers will be able to upgrade and downgrade between different Products within the *same* Product Family.  They will *not* be able to upgrade or downgrade between products in *different* families.
+
+Additionally, "Coupons":/coupons and "Components":/product-components are scoped by Product Family.  In other words, Coupons and Components from one Family will be accessible to Products within the same family, but not to Products in another Family.
+
 
 h3. Creating Product Families
 

diff --git a/doculab/docs/products-intro.textile b/doculab/docs/products-intro.textile
@@ -7,7 +7,7 @@ In your app or business, you might call these Products your "Plans" or "Feature
 
 h3. Product Families
 
-Products belong to a "*Product Family*":/product-families.  Product Families should contain the Products that are all different "feature levels" of the same thing - i.e. you can usually upgrade and downgrade between Products within the same Product Family.  The "Product Family documentation":/product-families goes in to more depth on how to structure your Product Family and Product relationships.
+Products belong to a "*Product Family*":/product-families.  Product Families should contain the Products that are all different "feature levels" of the same thing - i.e. you can usually upgrade and downgrade between Products within the same Product Family, *but not between Products in different Families*.  The "Product Family documentation":/product-families goes in to more depth on how to structure your Product Family and Product relationships.
 
 h3. Creating a Product