Documentation fixes: JSON Example, SSL Connection Examples, RTD versi…

…on (redis#1887)

docs/conf.py

@@ -35,6 +35,12 @@
     "sphinx.ext.autosectionlabel",
 ]
 
+# AutosectionLabel settings.
+# Uses a <page>:<label> schema which doesn't work for duplicate sub-section
+# labels, so set max depth.
+autosectionlabel_prefix_document = True
+autosectionlabel_maxdepth = 2
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
@@ -58,10 +64,10 @@
 # The short X.Y version.
 import redis
 
-version = ".".join(redis.__version__.split(".")[0:2])
-
-# The full version, including alpha/beta/rc tags.
-release = redis.__version__
+version = ".".join(redis.__version__.split(".")[0:3])
+release = version
+if version == "99.99.99":
+    release = "dev"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/redismodules.rst

@@ -110,6 +110,8 @@ These are the commands for interacting with the `RediSearch module <https://redi
 .. code-block:: python
 
     import redis
+    from redis.commands.search.field import TextField
+
     r = redis.Redis()
     r.ft().create_index(TextField("play", weight=5.0), TextField("ball"))
     print(r.ft().info())