From e943aff9956fd55a9459f332fb671006adc2f354 Mon Sep 17 00:00:00 2001
From: Bruno Oliveira <nicoddemus@gmail.com>
Date: Sun, 28 Apr 2019 20:01:22 -0300
Subject: [PATCH] Update blurb about Sybil

---
 doc/en/doctest.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/en/doctest.rst b/doc/en/doctest.rst
index 5ab548239..2cb70af72 100644
--- a/doc/en/doctest.rst
+++ b/doc/en/doctest.rst
@@ -79,9 +79,11 @@ putting them into a pytest.ini file like this:
 
 .. note::
 
-    If you are making serious use of doctests through your code, please checkout
-    `Sybil <https://sybil.readthedocs.io/en/latest/index.html>`__, which besides
-    supporting doctests also supports Sphinx directives, plus other features.
+    The builtin pytest doctest supports only ``doctest`` blocks, but if you are looking
+    for more advanced checking over *all* your documentation,
+    including doctests, ``.. codeblock:: python`` Sphinx directive support,
+    and any other examples your documentation may include, you may wish to
+    consider `Sybil <https://sybil.readthedocs.io/en/latest/index.html>`__.
     It provides pytest integration out of the box.