From fb00b79d1945a05c08f642aa35efbba5e92558a8 Mon Sep 17 00:00:00 2001
From: Erdenezul Batmunkh <erdenezul@shine.mn>
Date: Mon, 19 Jun 2017 03:28:34 +0000
Subject: [PATCH] add docs for positional push operator #1565

---
 docs/guide/querying.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/guide/querying.rst b/docs/guide/querying.rst
index 0bb19658..f1594dd2 100644
--- a/docs/guide/querying.rst
+++ b/docs/guide/querying.rst
@@ -565,6 +565,15 @@ cannot use the `$` syntax in keyword arguments it has been mapped to `S`::
     >>> post.tags
     ['database', 'mongodb']
 
+From MongoDB version 2.6, push operator supports $position value which allows
+to push values with index.
+    >>> post = BlogPost(title="Test", tags=["mongo"])
+    >>> post.save()
+    >>> post.update(push__tags__0=["database", "code"])
+    >>> post.reload()
+    >>> post.tags
+    ['database', 'code', 'mongo']
+
 .. note::
     Currently only top level lists are handled, future versions of mongodb /
     pymongo plan to support nested positional operators.  See `The $ positional