@@ -215,6 +215,24 @@ To implement your custom memory allocator override Allocate, Free, Reallocate, A
 * A conan package is available [here](https://conan.io/center/recipes/joltphysics).
 * A RHEL RPM package is available [here](https://github.com/alkontek/pkgspecs/tree/master/rpm/JoltPhysics).
 
+## Building as a Shared Library
+
+To build Jolt as a shared library, pass `-DJPH_BUILD_SHARED_LIBS=ON` to cmake.
+This will turn on the `JPH_SHARED_LIBRARY` define for Jolt and cmake projects linking against Jolt.
+It turns on `JPH_BUILD_SHARED_LIBRARY` for Jolt only to force it to build a shared library instead of a static library.
+
+If you're not using cmake to build your project, define `JPH_SHARED_LIBRARY` in your project to cause it to bind to the shared library.
+Don't define `JPH_BUILD_SHARED_LIBRARY` in your project.
+
+## Building Your Project Without CMake
+
+When you're not using cmake, be careful to mirror the defines (e.g. `JPH_DOUBLE_PRECISION`, `JPH_DEBUG_RENDERER`, ...) that Jolt was compiled with in your project.
+`RegisterTypes` will attempt to verify this and will `Trace` any mismatches and then call `std::abort`. Make sure you override `Trace` to see the error.
+
+Some mismatches can lead to compile errors because function signatures can change based on the defines (see the Errors section).
+
+If you configured cmake to create a `Makefile` you can find the defines by running `make clean` followed by `make -n`. This will print the compiler command. Search for `-DJPH_` and copy those defines into your own project.
+
 ## Errors
 
 ### Link Error: File Format Not Recognized