deploy: 63c10a51fc

integration.md

@@ -1,4 +1,34 @@
-# Header only
+# Integration
+
+There are several ways to add this header-only library to a C++ project. The following flowchart summarizes how to
+pick one:
+
+```mermaid
+flowchart TD
+    A[Add the library to a C++ project] --> B{Already using CMake?}
+    B -- no --> C{Using pkg-config or plain Makefiles?}
+    C -- yes --> D[pkg-config]
+    C -- no --> E[Copy the single header]
+    B -- yes --> F{Library installed system-wide?}
+    F -- yes --> G["find_package()"]
+    F -- no --> H{Use a package manager?}
+    H -- yes --> I[Package manager]
+    H -- no --> J["add_subdirectory() or FetchContent"]
+```
+
+- **Copy the single header**, as described [below](#header-only) — no build-system integration required.
+- **CMake**: use [`find_package()`](cmake.md#external) if the library is already installed,
+  [`add_subdirectory()`](cmake.md#embedded) to embed the source tree, or [`FetchContent`](cmake.md#fetchcontent) to
+  download it at configure time; see [CMake](cmake.md).
+- **Package managers**: install the library with a package manager such as Homebrew, Conan, or vcpkg; see
+  [Package Managers](package_managers.md).
+- **pkg-config**: if you use bare Makefiles instead of CMake, [pkg-config](pkg-config.md) can supply the include flags
+  for an already-installed library.
+
+Once the library is integrated, see the [Migration Guide](migration_guide.md) for how to keep your code future-proof
+across releases.
+
+## Header only
 
 [`json.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json.hpp) is the single required
 file in `single_include/nlohmann` or [released here](https://github.com/nlohmann/json/releases). You need to add