yes

docs/theory/force_calibration/surface.rst

@@ -1,8 +1,8 @@
+.. _surface_models:
+
 Surface models
 --------------
 
-.. _surface_models:
-
 When doing experiments near the surface, the surface has an effect on the friction felt by the bead.
 This effect is due to the bead being close to the surface, which changes the drag experienced by the bead.
 Shown below is the drag coefficient at frequency zero (constant flow).

docs/tutorial/force_calibration/force_calibration.rst

@@ -31,9 +31,10 @@ The most important parameters are:
 Hydrodynamically correct model
 """"""""""""""""""""""""""""""
 
-For lateral calibration, it is recommended to use the
+For lateral calibration (e.g. `x` and `y`), it is recommended to use the
 :ref:`hydrodynamically correct theory<hydro_model_theory>` by setting `hydrodynamically_correct` to
 `True`) as it provides an improved model of the underlying physics.
+It takes into account inertial and hydrodynamical effects of the fluid and bead(s).
 For small beads (< 1 micron) the differences will be small, but for larger beads substantial
 differences can occur. There is only one exception to this recommendation, which is when the beads
 are so close to the flowcell surface (0.75 x diameter) that this model becomes invalid.
@@ -45,7 +46,8 @@ Pylake uses values for water and polystyrene for the sample and bead density res
 Experiments near the surface
 """"""""""""""""""""""""""""
 
-When doing experiments near the surface, it is recommended to provide a `distance_to_surface`.
+When doing experiments near the surface, it is recommended to provide a `distance_to_surface` since
+the surface has an :ref:`effect on the friction<surface_models>` felt by the bead.
 This distance should be the distance from the center of the bead to the surface of the flowcell.
 Since it can be challenging to determine this distance, it is recommended to use active calibration
 when calibrating near the surface, since active calibration makes calibration far less sensitive
@@ -60,18 +62,18 @@ to mis-specification of the bead diameter, viscosity and distance to the surface
 Technical considerations
 ************************
 
-Sensor
-""""""
+Force detector
+""""""""""""""
 
 In addition to the model that describes the bead's motion, it is important to take into account the
-:ref:`characteristics of the sensor<diode_theory>` used to measure the data.
+:ref:`characteristics of the force detector<diode_theory>` used to measure the data.
 
 A silicon diode sensor is characterized by two parameters, a "relaxation factor" `alpha` and
 frequency `f_diode`.
 These parameters can either be fitted along with the other parameters or characterized independently.
 
-You can check whether a Bluelake calibration item had to estimate parameters from the calibration
-data by checking the property `recalibrated.fitted_diode`.
+You can check whether Bluelake had to estimate parameters from the calibration
+data by checking the property :attr:`~lumicks.pylake.calibration.ForceCalibrationItem.fitted_diode`.
 When this property is set to true, it means that the diode parameters were not fixed during the fit.
 
 When fitted, care must be taken that the corner frequency of the power spectrum `fc` is