Documentation: Disable auto_doc_ref

According to recommonmark's documentation the enable_auto_doc_ref is deprecated.
This is not true, as it's broken with Sphinx 1.6+ commit

recommonmark bug report is here:

Instead of using this feature, which doesn't support top level directories in
the relative document path anyway, use the TOC tree or inline RST code.

Disable auto_doc_ref and document how to reference documents.

Change-Id: I9319985b504c4215c33ebbeb9c38317b9efcb283
Signed-off-by: Patrick Rudolph <>
Tested-by: build bot (Jenkins) <>
Reviewed-by: Tom Hiller <>
Reviewed-by: Philipp Deppenwiese <>
diff --git a/Documentation/ b/Documentation/
index ff1ad9d..07868fa 100644
--- a/Documentation/
+++ b/Documentation/
@@ -183,7 +183,7 @@
     from recommonmark.transform import AutoStructify
     app.add_config_value('recommonmark_config', {
         'enable_auto_toc_tree': True,
-        'enable_auto_doc_ref': True,
+        'enable_auto_doc_ref': False, # broken in Sphinx 1.6+
         'enable_eval_rst': True,
         'url_resolver': lambda url: '/' + url
     }, True)