Improves clarity in tutorials

Author: AndrewSazonov

tutorials/advanced_joint-fit_pd-neut-xray-cwl_PbSO4.py

@@ -1,5 +1,5 @@
 # %% [markdown]
-# # Joint Fit (Advanced)
+# # Standard Diffraction: PbSO4, NPD and XRD
 #
 # This example demonstrates a flexible and advanced use of the
 # EasyDiffraction library by explicitly creating and configuring objects.
@@ -20,7 +20,7 @@
 # %% [markdown]
 # ## Define Sample Model
 #
-# This section explains how to add sample models and modify their parameters.
+# This section shows how to add sample models and modify their parameters.
 #
 # ### Create Sample Model
 
@@ -55,7 +55,7 @@
 # %% [markdown]
 # ## Define Experiments
 #
-# This section explains how to add experiments, configure their parameters, and
+# This section shows how to add experiments, configure their parameters, and
 # link the sample models defined in the previous step.
 #
 # ### Experiment 1: npd
@@ -96,13 +96,13 @@
 # #### Set Background
 
 # %% [markdown]
-# Select Background Type
+# Select background type.
 
 # %%
 expt1.background_type = 'line-segment'
 
 # %% [markdown]
-# Add Background Points
+# Add background points.
 
 # %%
 for x, y in [
@@ -162,13 +162,13 @@
 # #### Set Background
 
 # %% [markdown]
-# Select Background Type
+# Select background type.
 
 # %%
 expt2.background_type = 'chebyshev polynomial'
 
 # %% [markdown]
-# Add Background Points
+# Add background points.
 
 # %%
 for x, y in [
@@ -190,7 +190,7 @@
 # %% [markdown]
 # ## Define Project
 #
-# The project object manages the sample model, experiments, and
+# The project object is used to manage the sample model, experiment, and
 # analysis.
 #
 # ### Create Project
@@ -214,8 +214,8 @@
 # %% [markdown]
 # ## Analysis
 #
-# This section explains the analysis process, including how to set
-# up calculators and fit models.
+# This section shows the analysis process, including how to set up
+# calculation and fitting engines.
 #
 # ### Set Calculator
 
@@ -237,15 +237,15 @@
 # %% [markdown]
 # ### Set Fitting Parameters
 #
-# Set sample model parameters to be refined
+# Set sample model parameters to be refined.
 
 # %%
 model.cell.length_a.free = True
 model.cell.length_b.free = True
 model.cell.length_c.free = True
 
 # %% [markdown]
-# Set experiment parameters to be refined
+# Set experiment parameters to be refined.
 
 # %%
 expt1.linked_phases['pbso4'].scale.free = True
@@ -277,7 +277,7 @@
 project.analysis.fit()
 
 # %% [markdown]
-# ### Show Results
+# ### Plot Measured vs Calculated
 
 # %%
 project.plot_meas_vs_calc(expt_name='npd',