diff --git a/Documentation/ProjectFile/prj/processes/process/THERMO_RICHARDS_MECHANICS/t_initialize_porosity_from_medium_property.md b/Documentation/ProjectFile/prj/processes/process/THERMO_RICHARDS_MECHANICS/t_initialize_porosity_from_medium_property.md
new file mode 100644
index 0000000000000000000000000000000000000000..1a0566e1b4e6df2244f88f4db2e4f562d9405d70
--- /dev/null
+++ b/Documentation/ProjectFile/prj/processes/process/THERMO_RICHARDS_MECHANICS/t_initialize_porosity_from_medium_property.md
@@ -0,0 +1,10 @@
+This optional parameter indicates whether the porosity and transport porosity
+should be initialized from the medium properties `porosity` and
+`transport_porosity`, respectively.
+
+This initialization is desired in almost all cases with one notable exception:
+simulation restart when a non-constant porosity model is used,
+e.g. with \ref ogs_file_param__prj__media__medium__properties__property__PorosityFromMassBalance "PorosityFromMassBalance"
+or \ref ogs_file_param__prj__media__medium__properties__property__TransportPorosityFromMassBalance "TransportPorosityFromMassBalance".
+
+In such a restart case simply set this parameter to `false`.