diff --git a/src/ifcopenshell-python/docs/ifcopenshell.rst b/src/ifcopenshell-python/docs/ifcopenshell.rst
index 45c864bf47..38c930ee91 100644
--- a/src/ifcopenshell-python/docs/ifcopenshell.rst
+++ b/src/ifcopenshell-python/docs/ifcopenshell.rst
@@ -16,6 +16,7 @@ compile-time when using C++ and at run-time when using Python.
    ifcopenshell/installation
    ifcopenshell/geometry_iterator
    ifcopenshell/geometry_settings
+   ifcopenshell/boolean_process
 
 Indices and tables
 ------------------
diff --git a/src/ifcopenshell-python/docs/ifcopenshell/boolean_process.rst b/src/ifcopenshell-python/docs/ifcopenshell/boolean_process.rst
new file mode 100644
index 0000000000..15e07d3519
--- /dev/null
+++ b/src/ifcopenshell-python/docs/ifcopenshell/boolean_process.rst
@@ -0,0 +1,6 @@
+Boolean process
+===============
+
+Booleans are one of the more complex aspects of 3D geometry processing. IfcOpenShell orchestrates a variety of OpenCASCADE commands to ensure that booleans (whether through IFC openings or through IFC representation booleans) are processed reliably:
+
+.. image:: images/boolean-process.jpg
diff --git a/src/ifcopenshell-python/docs/ifcopenshell/images/boolean-process.jpg b/src/ifcopenshell-python/docs/ifcopenshell/images/boolean-process.jpg
new file mode 100644
index 0000000000..f08eeb4a25
Binary files /dev/null and b/src/ifcopenshell-python/docs/ifcopenshell/images/boolean-process.jpg differ