diff --git a/doc/conf.py b/doc/conf.py
index 1e5a0227f1671b4097dfd3b92417b3c7729ac195..ac63d6cbeaf793d197dbfc821de4ffce568d4587 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -275,5 +275,7 @@ texinfo_documents = [
 #texinfo_no_detailmenu = False
 
 
-# Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'http://docs.python.org/': None}
+intersphinx_mapping = {
+    'http://docs.python.org/': None,
+    'https://documen.tician.de/pyopencl': None
+}
diff --git a/meshmode/discretization/__init__.py b/meshmode/discretization/__init__.py
index 6ff44165a61c6f2574ffdd914fb474bf9de9731b..aadf6d318dbdddc68d69c66ce0054b2954bd092c 100644
--- a/meshmode/discretization/__init__.py
+++ b/meshmode/discretization/__init__.py
@@ -68,12 +68,12 @@ class ElementGroupBase(object):
 
     .. method:: grad_basis()
 
-        :returns: a :class:`tuple` of functions, each of  which
-        accepts arrays of shape *(dims, npts)*
-        and returns a :class:`tuple` of length *dims* containing
-        the derivatives along each axis as an array of size *npts*.
-        'Scalar' evaluation, by passing just one vector of length *dims*,
-        is also supported.
+        :returns: a :class:`tuple` of functions, each of which
+            accepts arrays of shape *(dims, npts)* and returns a
+            :class:`tuple` of length *dims* containing the
+            derivatives along each axis as an array of size
+            *npts*.  'Scalar' evaluation, by passing just one
+            vector of length *dims*, is also supported.
 
     .. method:: diff_matrices()
 
@@ -86,6 +86,7 @@ class ElementGroupBase(object):
 
         Returns an array of length :attr:`nunit_nodes` containing
         quadrature weights.
+
     """
 
     def __init__(self, mesh_el_group, order, node_nr_base):
@@ -162,6 +163,13 @@ class OrderBasedGroupFactory(ElementGroupFactory):
 class Discretization(object):
     """An unstructured composite discretization.
 
+    :param cl_ctx: A :class:`pyopencl.Context`
+    :param mesh: A :class:`meshmode.mesh.Mesh` over which the discretization is
+        built
+    :param group_factory: An :class:`ElementGroupFactory`
+    :param real_dtype: The :mod:`numpy` data type used for representing real
+        data, either :class:`numpy.float32` or :class:`numpy.float64`
+
     .. attribute:: real_dtype
 
     .. attribute:: complex_dtype
@@ -189,6 +197,7 @@ class Discretization(object):
     .. method:: quad_weights(queue)
 
         shape: ``(nnodes)``
+
     """
 
     def __init__(self, cl_ctx, mesh, group_factory, real_dtype=np.float64):