diff --git a/source/blender/python/gpu/gpu_py_shader.cc b/source/blender/python/gpu/gpu_py_shader.cc
index 1042628d7bc..baa572baec4 100644
--- a/source/blender/python/gpu/gpu_py_shader.cc
+++ b/source/blender/python/gpu/gpu_py_shader.cc
@@ -929,7 +929,8 @@ PyDoc_STRVAR(
     ".. class:: GPUShader(vertexcode, fragcode, geocode=None, libcode=None, defines=None, "
     "name='pyGPUShader')\n"
     "\n"
-    "   Deprecated, use gpu.shader.create_from_info(shader_info) instead.\n"
+    "   Constructor is deprecated and will be removed in Blender 5.0, "
+    "use :func:`gpu.shader.create_from_info` instead.\n"
     "\n"
     "   GPUShader combines multiple GLSL shaders into a program used for drawing.\n"
     "   It must contain at least a vertex and fragment shaders.\n"
@@ -1098,7 +1099,7 @@ PyDoc_STRVAR(
     "   Create shader from a GPUShaderCreateInfo.\n"
     "\n"
     "   :arg shader_info: GPUShaderCreateInfo\n"
-    "   :type shader_info: :class:`bpy.types.GPUShaderCreateInfo`\n"
+    "   :type shader_info: :class:`gpu.types.GPUShaderCreateInfo`\n"
     "   :return: Shader object corresponding to the given name.\n"
     "   :rtype: :class:`gpu.types.GPUShader`\n");
 static PyObject *pygpu_shader_create_from_info(BPyGPUShader * /*self*/, BPyGPUShaderCreateInfo *o)
diff --git a/source/blender/python/gpu/gpu_py_shader_create_info.cc b/source/blender/python/gpu/gpu_py_shader_create_info.cc
index 984fc3e1cb5..56e1c42afe5 100644
--- a/source/blender/python/gpu/gpu_py_shader_create_info.cc
+++ b/source/blender/python/gpu/gpu_py_shader_create_info.cc
@@ -1128,9 +1128,9 @@ PyDoc_STRVAR(
     "\n"
     "   Example:\n"
     "\n"
-    ".. code-block:: python\n"
+    "   .. code-block:: python\n"
     "\n"
-    "   \"struct MyType {int foo; float bar;};\"\n"
+    "      \"struct MyType {int foo; float bar;};\"\n"
     "\n"
     "   :arg source: The source code defining types.\n"
     "   :type source: str\n");
@@ -1169,9 +1169,9 @@ PyDoc_STRVAR(
     "\n"
     "   Add a preprocessing define directive. In GLSL it would be something like:\n"
     "\n"
-    ".. code-block:: glsl\n"
+    "   .. code-block:: glsl\n"
     "\n"
-    "   #define name value\n"
+    "      #define name value\n"
     "\n"
     "   :arg name: Token name.\n"
     "   :type name: str\n"