diff --git a/tutorials/shaders/shader_reference/shading_language.rst b/tutorials/shaders/shader_reference/shading_language.rst
index d9461c24d5e..bc81961ea1c 100644
--- a/tutorials/shaders/shader_reference/shading_language.rst
+++ b/tutorials/shaders/shader_reference/shading_language.rst
@@ -124,8 +124,9 @@ using ``//`` for single-line comments and ``/* */`` for multi-line comments:
 Additionally, you can use documentation comments that are displayed in the
 inspector when hovering a shader parameter. Documentation comments are currently
 only supported when placed immediately above a ``uniform`` declaration. These
-documentation comments only support the **multiline** comment syntax and must use
-**two** leading asterisks (``/**``) instead of just one (``/*``):
+documentation comments only support the **multiline** comment syntax
+(even if used on a single line) and must use **two** leading asterisks
+(``/**``) instead of just one (``/*``):
 
 .. code-block:: glsl
 
@@ -137,6 +138,9 @@ documentation comments only support the **multiline** comment syntax and must us
      */
     uniform int something = 1;
 
+    /** This is a single-line documentation comment. */
+    uniform float something_else = 1.0;
+
 The asterisks on the follow-up lines are not required, but are recommended as
 per the :ref:`doc_shaders_style_guide`. These asterisks are automatically
 stripped by the inspector, so they won't appear in the tooltip.