From 0b0a3ed8f0e054454e47c931c1394d31fedb9afb Mon Sep 17 00:00:00 2001
From: Daniel Lo <daniel.lo@lawgives.com>
Date: Fri, 14 Jun 2013 02:30:55 +0000
Subject: [PATCH] Added some verbage explaining Custom Relation Names.  The
 custom relation names initially confused me, because I was expecting more
 'Magic'.

---
 source/en/mongoid/docs/relations.haml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/source/en/mongoid/docs/relations.haml b/source/en/mongoid/docs/relations.haml
index 81a7ceb..be44dd6 100644
--- a/source/en/mongoid/docs/relations.haml
+++ b/source/en/mongoid/docs/relations.haml
@@ -96,6 +96,20 @@
       embedded_in :alcoholic, class_name: "Lush", inverse_of: :whiskey
     end
 
+  %p
+    In class <code>Lush</code> <code>:whiskey</code> is the variable name of 
+    the relation.  This relation contains many classes named <code>Drink</code>.   
+    The <code>inverse_of: :alcoholic</code> states that class <code>Drink</code> 
+    will have a variable named <code>:alcoholic</code> containing the inverse 
+    relationship pointing back to <code>:whiskey</code>.
+
+  %p
+    In the class <code>Drink</code>, <code>:alcoholic</code> is the variable 
+    name containing the relationship and that <code>:alcoholic</code> is a class 
+    of <code>Lush</code>.  <code>Lush</code> contains a variable named 
+    <code>:whiskey</code> that points back to <code>Drink</code>.
+
+
   %h3 Validations
 
   %p