diff --git a/doc/usage/referencing.rst b/doc/usage/referencing.rst
index 2597c9ce597..571d3c798bc 100644
--- a/doc/usage/referencing.rst
+++ b/doc/usage/referencing.rst
@@ -136,8 +136,8 @@ There is also a way to directly link to documents:
 
 .. rst:role:: doc
 
-   Link to the specified document; the document name can be specified in
-   absolute or relative fashion.  For example, if the reference
+   Link to the specified document; the document name can be a relative or absolute
+   path and is always case-sensitive, even on Windows.  For example, if the reference
    ``:doc:`parrot``` occurs in the document ``sketches/index``, then the link
    refers to ``sketches/parrot``.  If the reference is ``:doc:`/people``` or
    ``:doc:`../people```, the link refers to ``people``.