From 1d1dcab2b301bd57a4a2dfee447d3c385e61fd8c Mon Sep 17 00:00:00 2001
From: hackerkid <hackerkid@vishnuks.com>
Date: Mon, 23 Jan 2017 22:31:30 +0530
Subject: [PATCH] requirements: Add comment explaining why CommonMark can't be
 upgraded.

Fixes #3398.
---
 requirements/docs.txt | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/requirements/docs.txt b/requirements/docs.txt
index 9437e33e9bbe1..c28ffe30923ec 100644
--- a/requirements/docs.txt
+++ b/requirements/docs.txt
@@ -12,6 +12,9 @@ recommonmark==0.4.0
 # Dependencies of Sphinx
 alabaster==0.7.9
 babel==2.3.4
+# Upgrading to the latest version of CommonMark breaks the
+# compatibility with recommonmark.  See
+# https://github.com/rtfd/recommonmark/issues/24
 CommonMark==0.5.4
 docutils==0.13.1
 imagesize==0.7.1