[recipes] Explain spice levels

[Matthias Clasen <matthiasc src gnome org>]

commit c8446382a1f4f3cdcd535376f50a870a9f49296f
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Feb 25 22:50:35 2017 -0500

    Explain spice levels
    
    Add a comment that spells out how we currently treat spiciness
    levels, since it isn't entirely obvious.

 src/gr-spice-row.c |   24 ++++++++++++++++++++++++
 1 files changed, 24 insertions(+), 0 deletions(-)
---
diff --git a/src/gr-spice-row.c b/src/gr-spice-row.c
index 0e156eb..8fb7452 100644
--- a/src/gr-spice-row.c
+++ b/src/gr-spice-row.c
@@ -26,6 +26,30 @@
 #include "gr-spice-row.h"
 
 
+/** Spiciness levels:
+ *
+ *  We use numbers between 0 and 100 for spiciness, currently, and we discriminate
+ *  4 levels of spiciness:
+ *  mild:     0 - 24
+ *  spicy:   25 - 49
+ *  hot:     50 - 74
+ *  extreme: 75 - 99
+ *
+ *  When selecting values in the edit, we assign the following values:
+ *  mild:    15
+ *  spicy:   40
+ *  hot:     60
+ *  extreme: 90
+ *
+ *  For the search, we have the following queries in the list:
+ *  mild:             < 25
+ *  at most spicy:    < 50
+ *  at least spicy:  >= 25
+ *  at most hot:      < 75
+ *  at least hot:    >= 50
+ *  very spicy:      >= 75
+ */
+
 struct _GrSpiceRow
 {
         GtkListBoxRow parent_instance;