diff --git a/docs/markdown/Dependencies.md b/docs/markdown/Dependencies.md
index 18512336c..401e019a3 100644
--- a/docs/markdown/Dependencies.md
+++ b/docs/markdown/Dependencies.md
@@ -51,6 +51,21 @@ If your boost headers or libraries are in non-standard locations you can set the
 
 GTest and GMock come as sources that must be compiled as part of your project. With Meson you don't have to care about the details, just pass `gtest` or `gmock` to `dependency` and it will do everything for you. If you want to use GMock, it is recommended to use GTest as well, as getting it to work standalone is tricky.
 
+## MPI ##
+
+MPI is supported for C, C++ and Fortran. Because dependencies are
+language-specific, you must specify the requested language using the
+`language` keyword argument, i.e.,
+ * `dependency('mpi', language='c')` for the C MPI headers and libraries
+ * `dependency('mpi', language='cpp')` for the C++ MPI headers and libraries
+ * `dependency('mpi', language='fortran')` for the Fortran MPI headers and libraries
+
+Meson prefers pkg-config for MPI, but if your MPI implementation does not
+provide them, it will search for the standard wrapper executables, `mpic`,
+`mpicxx`, `mpic++`, `mpifort`, `mpif90`, `mpif77`. If these are not in your
+path, they can be specified by setting the standard environment variables
+`MPICC`, `MPICXX`, `MPIFC`, `MPIF90`, or `MPIF77`, during configuration.
+
 ## Qt5 ##
 
 Meson has native Qt5 support. Its usage is best demonstrated with an example.
diff --git a/docs/markdown/Release-notes-for-0.42.0.md b/docs/markdown/Release-notes-for-0.42.0.md
index 0fa27c3d8..f3127de7f 100644
--- a/docs/markdown/Release-notes-for-0.42.0.md
+++ b/docs/markdown/Release-notes-for-0.42.0.md
@@ -104,3 +104,11 @@ By default Meson adds the current source and build directories to the
 header search path. On some rare occasions this is not desired. Setting
 the `implicit_include_directories` keyword argument to `false` these
 directories are not used.
+
+## Support for MPI dependency
+
+MPI is now supported as a dependency. Because dependencies are
+language-specific, you must specify the requested language with the `language`
+keyword, i.e., `dependency('mpi', language='c')` will request the C MPI headers
+and libraries. See [the MPI dependency](Dependencies.md#mpi) for more
+information.