docs: edit example file

Author: yucongalicechen

doc/source/examples/diffraction_objects_example.rst

@@ -106,23 +106,26 @@ we would replace the code above with
 The ``scale_to()`` method returns a new ``DiffractionObject`` which we can assign to a new
 variable and make use of,
 
+The default behavior is to align the objects based on the maximal q-value of each diffraction object,
+so they will align at the intensity at these indices.
+
 .. code-block:: python
 
-    scaled_measured = measured.scale_to(calculated, q=5.5)
+    scaled_measured = measured.scale_to(calculated)
 
-For convenience, you can also apply an offset to the scaled new diffraction object with the optional
-``offset`` argument, for example,
+If this doesn't give the desirable results, you can specify an ``xtype=value`` to scale
+based on the closest x-value in both objects. For example:
 
 .. code-block:: python
 
-    scaled_and_offset_measured = measured.scale_to(calculated, q=5.5, offset=0.5)
+    scaled_measured = measured.scale_to(calculated, q=5.5)
 
-You can call `scale_to()` without specifying a value for `q`, `tth`, or `d`.
-In this case, the scaling will be done based on the maximal x-array value of both diffraction objects:
+For convenience, you can also apply an offset to the scaled new diffraction object with the optional
+``offset`` argument, for example,
 
 .. code-block:: python
 
-    scaled_measured = measured.scale_to(calculated)
+    scaled_and_offset_measured = measured.scale_to(calculated, q=5.5, offset=0.5)
 
 DiffractionObject convenience functions
 ---------------------------------------