diff --git a/docs/contributing.md b/docs/contributing.md
index d21323d991..ef7fc0c356 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -21,8 +21,8 @@ to the codebase itself.
 
 ## Using Git(Hub)
 
-Ongoing development happens in the `devel` branch for Catch2 v3, and in
-`v2.x` for maintenance updates to the v2 versions.
+Ongoing development happens in the `devel` branch for Catch2 v3.
+The `v2.x` branch is in maintenance mode for critical fixes only.
 
 Commits should be small and atomic. A commit is atomic when, after it is
 applied, the codebase, tests and all, still works as expected. Small
diff --git a/docs/migrate-v2-to-v3.md b/docs/migrate-v2-to-v3.md
index 84ed76904a..98fa732f6e 100644
--- a/docs/migrate-v2-to-v3.md
+++ b/docs/migrate-v2-to-v3.md
@@ -53,8 +53,8 @@ compilation times in the v3 version. The basic steps to do so are:
 you use Catch2's default main. (If you do not, keep linking against
 the `Catch2` target.). If you use pkg-config, change `pkg-config catch2` to
 `pkg-config catch2-with-main`.
-2. Delete TU with `CATCH_CONFIG_RUNNER` or `CATCH_CONFIG_MAIN` defined,
-as it is no longer needed.
+2. Remove `CATCH_CONFIG_RUNNER` or `CATCH_CONFIG_MAIN` definitions from your code,
+as they are no longer needed in v3.
 3. Change `#include <catch2/catch.hpp>` to `#include <catch2/catch_all.hpp>`
 4. Check that everything compiles. You might have to modify namespaces,
 or perform some other changes (see the
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9da1a2e177..d3c21140f1 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1369,7 +1369,7 @@ than `single_include/catch.hpp`.**
 
 ### Improvements
 * pkg-config and CMake integration has been rewritten
-  * If you use them, the new include path is `#include <catch2/catch.hpp>`
+  * If you use them, the new include path is `#include <catch2/catch_all.hpp>`
   * CMake installation now also installs scripts from `contrib/`
   * For details see the [new documentation](cmake-integration.md#top)
 * Reporters now have a new customization point, `ReporterPreferences::shouldReportAllAssertions`
@@ -1438,8 +1438,8 @@ than `single_include/catch.hpp`.**
   * See [documentation for details](https://github.com/catchorg/Catch2/blob/devel/docs/matchers.md)
 
 ### Others
-* Modified CMake-installed pkg-config to allow `#include <catch.hpp>`(#1239)
-  * The plans to standardize on `#include <catch2/catch.hpp>` are still in effect
+* Modified CMake-installed pkg-config to allow `#include <catch2/catch_all.hpp>`(#1239)
+* The plans to standardize on `#include <catch2/catch_all.hpp>` are still in effect
 
 
 ## 2.2.1