Fixed SAL script format and few minor changes

AuxTel/Troubleshooting/General-Troubleshooting/AuxTel-Rotator-Out-Of-Range.rst

@@ -29,20 +29,23 @@ AuxTel Rotator Out Of Range
 Overview
 ========
 
-When observing during the night, `latiss_acquire` (Spectroscopic survey) or `track_target_and_take_image` (Imaging survey) scripts failed with the error message:
+:file:`latiss_acquire` (Spectroscopic survey) or :file:`track_target_and_take_image` (Imaging survey) 
+script failed with the error message:
 
 .. code-block:: text
 
-    Rejected: Rotator out of range 
+    Rejected: Rotator out of range. Target in rotator limit (-170 to 170 degrees) but out of slew limit margin (1 degs).
 
-and ATPtg might goes into ``FAULT``.
+and *ATPtg* might goes into ``FAULT``.
 
 .. _AuxTel-Rotator-Out-Of-Range-Error-Diagnosis:
 
 Error diagnosis
 ===============
 
-During the imaging or spectroscopic surveys, the scripts `latiss_acquire` (Spectroscopic survey) or `track_target_and_take_image` (Imaging survey) fail with the following error:
+During the imaging or spectroscopic surveys, :file:`latiss_acquire` (Spectroscopic survey) or :file:`track_target_and_take_image` (Imaging survey) 
+causing *ATPtg* to fault. 
+The full traceback error received is:
 
 .. code-block:: text
 
@@ -67,12 +70,13 @@ During the imaging or spectroscopic surveys, the scripts `latiss_acquire` (Spect
 Procedure Steps
 ===============
 
-The interim solution requires recovering the *ATPtg* back to ``ENABLED`` in the case it went to ``FAULT``, and skiping to the next target in the ATQueue by pressing the :guilabel:`PLAY` buttom. 
+The interim solution requires recovering the *ATPtg* back to ``ENABLED`` in the case it went to ``FAULT``, and skipping to the next target in the ATQueue 
+by pressing the :guilabel:`PLAY` button. 
 If this script also fails with the same error, wait three minutes and try again.
 
 
-#. Recover *ATPtg* from ``FAULT`` state: Transition the *ATPtg* *CSC* from LOVE ASummaryState through the states, ``FAULT`` → ``STANDBY`` → ``START`` → ``ENABLED``
-#. Add a `correct_pointing.py` script to the queue to recover the pointing offsets from the beginning of the night. No configuration is needed, you can use the default configuration.  
+#. Recover *ATPtg* from ``FAULT`` state: Transition the *ATPtg* *CSC* from LOVE ASummaryState through the states, ``FAULT`` → ``STANDBY`` → ``START`` → ``ENABLED``.
+#. Add a :file:`auxtel/correct_pointing.py` script to the top of the queue to recover the pointing offsets from the beginning of the night. No configuration is needed, you can use the default configuration.  
 #. Press :guilabel:`PLAY` button in the ATQueue: This will skip to the next target waiting in the queue.
 #. If this "new" script fails as well, wait three minutes and repeat 1-2 again.
 #. Log in relevant information about this failure in the ticket `OBS-52 <https://rubinobs.atlassian.net/browse/OBS-52>`__.
@@ -81,28 +85,29 @@ If this script also fails with the same error, wait three minutes and try again.
 Alternative Procedure
 =====================
 
-In case previous steps did not work, rotator continues failing and *ATPtg* never went to ``FAULT`` state, there is an alternative solution as follows:
+In case the previous steps did not work, rotator continues failing and *ATPtg* never went to ``FAULT`` state, there is an alternative solution as follows. 
 
-1. Find a target with the standard script `auxtel/track_target.py` and use the following configuration:
-
-.. code-block:: text
+#. Track a new target placing the standard script :file:`auxtel/track_target.py` at the top of the queue. 
+   Use the following configuration:
+
+   .. code-block:: text
     :caption: track_target.py
 
     az: 90.0
     el: 60.0
     mag_limit: 8.0
 
-2. Then run the external `auxtel/correct_pointing.py` on the same area of the sky.
+#. Then run the external :file:`auxtel/correct_pointing.py`:
 
-.. code-block:: text
+   .. code-block:: text
     :caption: correct_pointing.py
 
     az: 90.0
     el: 60.0
 
-3. Press :guilabel:`PLAY` button in the ATQueue.
+#. Press :guilabel:`PLAY` button in the ATQueue.
 
-4. Log in relevant information about this failure in the ticket `OBS-52 <https://rubinobs.atlassian.net/browse/OBS-52>`__.
+#. Log in relevant information about this failure in the ticket `OBS-52 <https://rubinobs.atlassian.net/browse/OBS-52>`__.
 
 
 .. _AuxTel-Rotator-Out-Of-Range-Post-Condition: