diff --git a/docs/source/release/v4.2.0/diffraction.rst b/docs/source/release/v4.2.0/diffraction.rst
index 0e39bf12b8bdb8817a4d5f623f05d1619f70341b..1d006affdb7848ced6cb5df2065522093e95ec82 100644
--- a/docs/source/release/v4.2.0/diffraction.rst
+++ b/docs/source/release/v4.2.0/diffraction.rst
@@ -21,6 +21,7 @@ Improvements
 - Geometry definition for LLB 5C1
 - :ref:`SNAPReduce <algm-SNAPReduce-v1>` has an additional parameter ``MaxChunkSize`` for customizing the chunking behavior
 - :ref:`LorentzCorrection <algm-LorentzCorrection-v1>` has an additional option for single crystal (default) or powder operation
+- The create_total_scattering_pdf method in Polaris scripts now supports merging banks with a weighted mean.
 
 Bug Fixes
 #########
diff --git a/docs/source/techniques/ISISPowder-Polaris-v1.rst b/docs/source/techniques/ISISPowder-Polaris-v1.rst
index 9152d3320bf855dcb19d26a115e484c1054181c9..9f17aa8085fb8cc9114af999d5b16c57470caf4b 100644
--- a/docs/source/techniques/ISISPowder-Polaris-v1.rst
+++ b/docs/source/techniques/ISISPowder-Polaris-v1.rst
@@ -168,7 +168,10 @@ The *create_total_scattering_pdf* method allows a user to create a Pair Distribu
 from focused POLARIS data, with a view performing further total scattering analysis.
 
 With no merging criteria specified, *merge_banks=False* a PDF will be generated for each bank within
-the focused_workspace.
+the focused_workspace. If run with *merge_banks=True* a PDF will be generated based on the wighted
+sum of the detector banks performed using supplied Q limits *q_lims=q_limits*, Q_limits can be in the
+form of a numpy array with shape (2, x) where x is the number rof detectors, or a string containing the
+directory of an appropriately formatted `.lim` file.
 
 This function requires the run_number you wish to analyse. The focused file for this run number must
 either be loaded in Mantid with the naming format given by the *focus* method: