From 522f37b1a0cbfe010a93e44a9d8550f60de8dbd2 Mon Sep 17 00:00:00 2001 From: Samir Shah Date: Sat, 6 May 2017 08:23:06 +0300 Subject: [PATCH] Improve documentation of Product Options. Try to make it clearer how these are different from Attributes. Resolves #1776. --- docs/source/ref/glossary.rst | 7 ++++++- docs/source/topics/modelling_your_catalogue.rst | 3 +++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/source/ref/glossary.rst b/docs/source/ref/glossary.rst index 97314f42582..e470922649a 100644 --- a/docs/source/ref/glossary.rst +++ b/docs/source/ref/glossary.rst @@ -76,4 +76,9 @@ This is a work-in-progress list of commonly used terms when discussing Oscar. Options are values that can be associated with a item when it is added to a customer's basket. This could be something like a personalised - message to be printed on a T-shirt. + message to be printed on a T-shirt, or a colour choice. + + Product Options are different from Product Attributes in that they are + used to specify a specific purchase choice by the customer, whereas + Attributes exist to store and display the features of a product in + a structured way. diff --git a/docs/source/topics/modelling_your_catalogue.rst b/docs/source/topics/modelling_your_catalogue.rst index 5b8e17f4cb5..3eae50c4ce7 100644 --- a/docs/source/topics/modelling_your_catalogue.rst +++ b/docs/source/topics/modelling_your_catalogue.rst @@ -35,6 +35,9 @@ to customise the underlying Django models. There's different types of attributes, e.g. ones for just associating text (type ``text`` or ``richtext``), for related images and files (type ``image`` and ``file``), etc. +Storing data in structured attributes also makes it easy to search and filter +products based on specific attributes. + The available product attributes for a product are set when creating the product's class. The sandbox comes with a product class for T-shirts, and they have a ``size`` attribute::