diff --git a/doc/images/bsdf_lambertian_plain.jpg b/doc/images/bsdf_lambertian_plain.jpg
index ba97544d..3d6ac956 100644
Binary files a/doc/images/bsdf_lambertian_plain.jpg and b/doc/images/bsdf_lambertian_plain.jpg differ
diff --git a/doc/images/bsdf_lambertian_textured.jpg b/doc/images/bsdf_lambertian_textured.jpg
index 57e8540e..104ccf2b 100644
Binary files a/doc/images/bsdf_lambertian_textured.jpg and b/doc/images/bsdf_lambertian_textured.jpg differ
diff --git a/src/bsdfs/dielectric.cpp b/src/bsdfs/dielectric.cpp
index 2eec28ff..5de0909c 100644
--- a/src/bsdfs/dielectric.cpp
+++ b/src/bsdfs/dielectric.cpp
@@ -33,9 +33,9 @@ MTS_NAMESPACE_BEGIN
  * }
  *
  * \renderings{
- *     \medrendering{Air-Water (IOR: 1$\leftrightarrow$1.33) interface, see \lstref{dielectric-water}}{bsdf_dielectric_water}
- *     \medrendering{Air-Diamond (IOR: 1$\leftrightarrow$2.419)}{bsdf_dielectric_diamond}
- *     \medrendering{Air-Glass (1$\leftrightarrow$1.504) interface with absorption, see \lstref{dielectric-glass}}{bsdf_dielectric_glass}
+ *     \medrendering{Air$\leftrightarrow$Water (IOR: 1.33) interface. See \lstref{dielectric-water}.}{bsdf_dielectric_water}
+ *     \medrendering{Air$\leftrightarrow$Diamond (IOR: 2.419)}{bsdf_dielectric_diamond}
+ *     \medrendering{Air$\leftrightarrow$Glass (IOR: 1.504) interface and absorption within. See \lstref{dielectric-glass}.}{bsdf_dielectric_glass}
  * }
  *
  * This plugin models an interface between two dielectric materials having mismatched 
diff --git a/src/bsdfs/roughdielectric.cpp b/src/bsdfs/roughdielectric.cpp
index 958e148e..f59aaf0c 100644
--- a/src/bsdfs/roughdielectric.cpp
+++ b/src/bsdfs/roughdielectric.cpp
@@ -40,7 +40,8 @@ MTS_NAMESPACE_BEGIN
  *           \item \code{ggx}: New distribution proposed by
  *               Walter et al. meant to better handle the long
  *               tails observed in transmission measurements through
- *               ground glass. 
+ *               ground glass. Renderings with this distribution may
+ *               converge slowly.
  *       \end{enumerate}
  *       Default: \code{beckmann}
  *     }