docs #38; updated

Author: barseghyanartur

advanced_usage_examples.rst

@@ -441,8 +441,8 @@ Sample view
         # Define search fields
         search_fields = (
             'title',
-            'description',
             'summary',
+            'description',
         )
         # Define filtering fields
         filter_fields = {
@@ -542,6 +542,32 @@ fields add multiple ``search`` query params and field names separated with
 
     http://127.0.0.1:8080/search/books/?search=title|education&search=summary|technology
 
+**Search with boosting**
+
+It's possible to boost search fields. In order to do that change the
+`search_fields` definition of the `BookDocumentViewSet` as follows:
+
+.. code-block:: python
+
+    class BookDocumentView(BaseDocumentViewSet):
+        """The BookDocument view."""
+
+        # ...
+
+        # Define search fields
+        search_fields = {
+            'title': {'boost': 4},
+            'summary': {'boost': 2},
+            'description': None,
+        }
+
+        # Order by `_score` first.
+        ordering = ('_score', 'id', 'title', 'price',)
+
+        # ...
+
+Note, that we are ordering results by `_score` first.
+
 Filtering
 ~~~~~~~~~
 

docs/advanced_usage_examples.rst

@@ -441,8 +441,8 @@ Sample view
         # Define search fields
         search_fields = (
             'title',
-            'description',
             'summary',
+            'description',
         )
         # Define filtering fields
         filter_fields = {
@@ -542,6 +542,32 @@ fields add multiple ``search`` query params and field names separated with
 
     http://127.0.0.1:8080/search/books/?search=title|education&search=summary|technology
 
+**Search with boosting**
+
+It's possible to boost search fields. In order to do that change the
+`search_fields` definition of the `BookDocumentViewSet` as follows:
+
+.. code-block:: python
+
+    class BookDocumentView(BaseDocumentViewSet):
+        """The BookDocument view."""
+
+        # ...
+
+        # Define search fields
+        search_fields = {
+            'title': {'boost': 4},
+            'summary': {'boost': 2},
+            'description': None,
+        }
+
+        # Order by `_score` first.
+        ordering = ('_score', 'id', 'title', 'price',)
+
+        # ...
+
+Note, that we are ordering results by `_score` first.
+
 Filtering
 ~~~~~~~~~
 

docs/changelog.rst

@@ -15,6 +15,17 @@ are used for versioning (schema follows below):
   0.3.4 to 0.4).
 - All backwards incompatible changes are mentioned in this document.
 
+0.7.1
+-----
+2018-04-04
+
+.. note::
+
+    Release supported by `Goldmund, Wyldebeast & Wunderliebe
+    <https://goldmund-wyldebeast-wunderliebe.nl/>`_
+
+- Add query `boost` support for search fields.
+
 0.7
 ---
 2018-03-08

src/django_elasticsearch_dsl_drf/__init__.py

@@ -3,7 +3,7 @@
 """
 
 __title__ = 'django-elasticsearch-dsl-drf'
-__version__ = '0.7'
+__version__ = '0.7.1'
 __author__ = 'Artur Barseghyan <[email protected]>'
 __copyright__ = '2017-2018 Artur Barseghyan'
 __license__ = 'GPL 2.0/LGPL 2.1'