From 1c09d982bc5dc993d185e0a3a2195b531723ab39 Mon Sep 17 00:00:00 2001
From: Xavier Morel <xmo@openerp.com>
Date: Mon, 21 May 2012 09:25:00 +0200
Subject: [PATCH] [ADD] note about non-standard fields in facets and facet
 values

bzr revid: xmo@openerp.com-20120521072500-bzjlrybvtepgryq2
---
 doc/search-view.rst | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/doc/search-view.rst b/doc/search-view.rst
index 02a239924e5..f94132bf3bd 100644
--- a/doc/search-view.rst
+++ b/doc/search-view.rst
@@ -376,8 +376,17 @@ necessarily having to reimplement all of
     or ``@filter_domain``. ``"="`` for
     :js:class:`~openerp.web.search.Field`
 
-Converting to facet objects
----------------------------
+Arbitrary data storage
+++++++++++++++++++++++
+
+:js:class:`~openerp.web.search.Facet` and
+:js:class:`~openerp.web.search.FacetValue` objects (and structures)
+provided by your widgets should never be altered by the search view
+(or an other widget). This means you are free to add arbitrary fields
+in these structures if you need to (because you have more complex
+needs than the attributes described in this document).
+
+Ideally this should be avoided, but the possibility remains.
 
 Changes
 -------