Making wording clearer and fixing a repetition in css file and renaming to make it more specific

Sasha Jade Horney · Sasha Jade Horney · commit ef0dd1b9915a · 2025-08-29T14:39:09.000+02:00
diff --git a/docs/assets/images/rdtfeeddown_gui/help.png b/docs/assets/images/rdtfeeddown_gui/help.png
diff --git a/docs/css/extra.css b/docs/css/extra.css
@@ -101,30 +101,20 @@ a.cern_internal {
   cursor: pointer;
 }
 
-.guilabel {
-    white-space: nowrap;
-    padding: 0.5px 6px;
-    width: fit-content;
-    border-radius: 4px;
-    font-weight: bold;
-    display: inline-block;
-}
-
-.guilabel {
+.rdtfeeddown_guilabel {
     white-space: nowrap;
     padding: 0.5px 12px;
     width: fit-content;
     border-radius: 0px;
     font-weight: bold;
     display: inline-block;
-    background: var(--guilabel-bg, #3c3c3c);
-    color: var(--guilabel-fg, #ffffff);
+    background: var(--rdtfeeddown_guilabel-bg, #3c3c3c);
+    color: var(--rdtfeeddown_guilabel-fg, #ffffff);
     box-shadow: 0 1px 2px rgba(0,0,0,0.12);
-    border: white;
     font-size: 1em;
 }
 
-a.tab-link {
+a.rdtfeeddown_tab-link {
     display: inline-block;
     padding: 0.15em 0.7em;
     border-radius: 0px;
@@ -139,7 +129,7 @@ a.tab-link {
     box-shadow: 0 2px 6px rgba(21,101,192,0.08);
     transition: background 0.2s, color 0.2s, border-bottom 0.2s;
 }
-a.tab-link:hover, a.tab-link:focus {
+a.rdtfeeddown_tab-link:hover, a.rdtfeeddown_tab-link:focus {
     background: #484848;
     color: #ffffff;
 }
diff --git a/docs/guis/rdt_feeddown/correction.md b/docs/guis/rdt_feeddown/correction.md
@@ -4,9 +4,9 @@ This part of the GUI allows you to quantify the RDT correction predicted from a
 
 ## The Tabs Explained
 
-- [Graph](#__tabbed_1_1){.tab-link} tab: Displays the RDT feeddown data and the correction prediction graphically.
+- [Graph](#__tabbed_1_1){.rdtfeeddown_tab-link} tab: Displays the RDT feeddown data and the correction prediction graphically.
 
-- [Response](#__tabbed_1_2){.tab-link} tab (optional): Allows you to quantify the RDT shift predicted from a specific corrector.
+- [Response](#__tabbed_1_2){.rdtfeeddown_tab-link} tab (_optional_): Allows you to quantify the RDT shift predicted from a specific corrector.
 
 === "Graph Tab"
 
@@ -19,11 +19,11 @@ This part of the GUI allows you to quantify the RDT correction predicted from a
 
     **Main Features:**
 
-    - <span class="guilabel">Load Files</span>: Load the corrector response files generated by the [Response](#__tabbed_1_2){.tab-link} tab.
+    - <span class="rdtfeeddown_guilabel">Load Files</span>: Load the corrector response files generated by the [Response](#__tabbed_1_2){.rdtfeeddown_tab-link} tab.
 
-    - ``Analysis File to Match``: Select the output file from the [Input](input.md){.tab-link} tab that you want to match with the corrector response.
+    - ``Analysis File to Match``: Select the output file from the [Input](input.md){.rdtfeeddown_tab-link} tab that you want to match with the corrector response.
 
-    - <span class="guilabel" style="--guilabel-bg: #5C62D6;">Plot</span>: Plot the RDT data and the correction prediction. This will trigger a list of corrector knobs to be shown beneath the **Knob Manager** section. These will default to a value of 0. Values can be changed by entering a number and pressing <kbd>Enter</kbd> or clicking <span class="guilabel" style="--guilabel-bg: #5C62D6;">Update Knobs and Re-Plot</span>.
+    - <span class="rdtfeeddown_guilabel" style="--rdtfeeddown_guilabel-bg: #5C62D6;">Plot</span>: Plot the RDT data and the correction prediction. This will trigger a list of corrector knob names to be shown beneath the **Knob Manager** section. These will default to a value of 0. Values can be changed by entering a number and pressing <kbd>Enter</kbd> or clicking <span class="rdtfeeddown_guilabel" style="--rdtfeeddown_guilabel-bg: #5C62D6;">Update Knobs and Re-Plot</span>.
 
 === "Response Tab"
 
@@ -34,16 +34,19 @@ This part of the GUI allows you to quantify the RDT correction predicted from a
     </center>
     </figure>
 
-    Similar to the [Input](input.md){.tab-link} tab, this tab allows you to load measurement folders and reference data in the format outputted by the [OMC analysis tools](https://pylhc.github.io/packages/omc3/about.html) for results of measurements.
+    Similar to the [Input](input.md){.rdtfeeddown_tab-link} tab, this tab allows you to load measurement folders and reference data in the format outputted by the [OMC analysis tools](omc_homepage) to quantify the RDT response for a constant corrector strength between 2 different crossing angles.
+
+    !!! warning "Response Behaviour Assumption Warning"
+        This assumes a linear response!
 
     **Main Features:**
 
     - ``Reference Folder``: Select the reference measurement folder containing the measurement data with the corrector strength applied and the reference crossing angle.
 
     - ``Response Folder``: Select the measurement folder containing the data with the <span class="warning-colored">same corrector strength</span> as the <span class="warning-colored">reference measurement</span> applied, and a <span class="warning-colored">different crossing angle</span> to the <span class="warning-colored">reference measurement</span> 
-    !!! tip
-        Will need to input the difference in crossing angle!
 
     - ``LHCB1 same as LHCB2 mode``: If this option is selected, the response will be calculated assuming that the corrector name is the same for both LHC beams. This is useful when the corrector name is not beam-specific.
 
-    - <span class="guilabel" style="--guilabel-bg: green;">Find Response</span>: This button will calculate the response of the RDT to the crossing angle with the corrector strength applied. The output will be in the format that can be used in the [Graph](#__tabbed_1_1){.tab-link} tab.
+    - <span class="rdtfeeddown_guilabel" style="--rdtfeeddown_guilabel-bg: green;">Find Response</span>: This button will calculate the response of the RDT to the crossing angle with the specified corrector strength applied. The output will be in the format that can be used in the [Graph](#__tabbed_1_1){.rdtfeeddown_tab-link} tab.
+
+        [omc_homepage]: https://pylhc.github.io/packages/omc3/about.html
diff --git a/docs/guis/rdt_feeddown/gui.md b/docs/guis/rdt_feeddown/gui.md
@@ -13,13 +13,16 @@ To launch and use the RDTfeeddown GUI, use the following command:
 python -m pip install omc3
 ```
 
+<img src="../../assets/images/rdtfeeddown_gui/help.png" alt="Help Icon" width="20"> or <img src="../../assets/images/rdtfeeddown_gui/help2.png" alt="Help Icon" width="20"> : shows some quick tips for using the GUI.
+
 <img src="../../assets/images/rdtfeeddown_gui/errorlog.png" alt="Error Log Icon" width="20"> : shows the error log for debugging.
 
-!!! tip
+!!! tip "Navigating Plots Tip"
     To pan in any of the plots, use <kbd>Ctrl</kbd>+<kbd>LeftClick</kbd> and drag the mouse.
 
 The following pages are available detailing the tabs and how to use them:
 
-- [Input](input.md){.tab-link} tab: for how to input files to produce an analysable format.
-- [Validation](validation.md){.tab-link} tab: for how to use that analysable format to plot the RDT response as a function of crossing angle amongst another analyses.
-- [Correction](correction.md){.tab-link} tab: for how to quantify the response of RDT with a corrector across crossing angles and use that to match to the analysable format measurement.
+- [Input](input.md){.rdtfeeddown_tab-link} tab: for how to input files to produce an analysable format.
+- [Validation](validation.md){.rdtfeeddown_tab-link} tab: for how to use that analysable format to plot the RDT response as a function of crossing angle amongst another analyses.
+- [Correction](correction.md){.rdtfeeddown_tab-link} tab: for how to quantify the response of RDT for a constant corrector powering, between two crossing angles (i.e. assuming linearity) and use that to match to the analysable format measurement.
+
diff --git a/docs/guis/rdt_feeddown/input.md b/docs/guis/rdt_feeddown/input.md
@@ -7,7 +7,7 @@
   </center>
 </figure>
 
-The [Input](input.md){.tab-link} tab (i.e. the landing page) of the GUI provides an interface to input data for the RDTfeeddown analysis.
+The [Input](input.md){.rdtfeeddown_tab-link} tab (i.e. the landing page) of the GUI provides an interface to input data for the RDTfeeddown analysis.
 
 You can load measurement folders, reference data, and crossing angle knob data directly through the GUI.
 
@@ -33,18 +33,22 @@ You can provide input to the RDTfeeddown GUI using the following methods:
 1. ``File Input``: Load input files by clicking the relevant button in the GUI and selecting the appropriate file.
 2. ``Manual Input``: Manually enter file paths in the provided fields within the GUI (except for measurement folders).
 
-!!! warning 
-    All folder inputs should be in the form used for the results of measurements in the [OMC analysis tools](https://pylhc.github.io/packages/omc3/about.html).
+!!! warning "Input Format Warning"
+    All folder inputs should be in the form used for the results directory of measurements in the [OMC analysis tools](omc_homepage).
 
 ## Input Fields Explained
 
-- ``Model``: Requires any model folder generated by the [OMC tools](https://pylhc.github.io/packages/omc3/about.html). Its only purpose is to provide the list of BPMs to look at.
+- ``Model``: Requires any model folder generated by the [OMC tools](omc_homepage). Its only purpose is to provide the list of BPMs to look at.
 - ``Reference Measurement Folder``: The measurement folder that contains the reference data.
 - ``Measurement Folders``: Folders containing the data you want to compare with the reference measurement.
+- ``Xing Knob Name``: The name of the crossing angle knob to use for the analysis in the exact form required by the `Timber` database.
 
 ## Simulation Mode
 
-``Simulation Mode``: allows you to use simulation data when no crossing angle knob data is available from `Timber`. In this case, the GUI will <span class="warning-colored">not</span> attempt to load any crossing angle knob data from `Timber` and will only use the provided properties file.
+``Simulation Mode``: allows you to use simulation data when no crossing angle knob data is available from `Timber`. In this case, the GUI will <span class="warning-colored">not</span> attempt to load any crossing angle knob data from `Timber` and will only use the provided properties file. 
+
+!!! warning "Xing Knob Name Consistency"
+    It will use the knob name given with <span class="warning-colored">no checks</span>, and this must be consistent across all measurements since plotting will fail if knob names are inconsistent.
 
 ## Properties File
 
@@ -54,12 +58,14 @@ The ``Properties File`` is a CSV file that contains the crossing angles used in
     <span style="color: #339AF0;">MATCH,</span> <span style="color: green;">KNOB</span>
 </div>
 <div style="height: 24px;"></div>
-Where <span style="background: var(--md-code-bg-color); color: #339AF0; font-family: monospace; font-size: 0.95em; border: 1px solid var(--color-background-border); padding: 2px 6px; border-radius: 0px;">MATCH</span> is the name of the measurement folder, and <span style="background: var(--md-code-bg-color); color: green; font-family: monospace; font-size: 0.95em; border: 1px solid var(--color-background-border); padding: 2px 6px; border-radius: 0px;">KNOB</span> is the value of the crossing angle knob for that measurement.
+Where <span style="background: var(--md-code-bg-color); color: #339AF0; font-family: monospace; font-size: 0.95em; border: 1px solid var(--color-background-border); padding: 2px 6px; border-radius: 0px;">MATCH</span> is the name of the measurement folder, and <span style="background: var(--md-code-bg-color); color: green; font-family: monospace; font-size: 0.95em; border: 1px solid var(--color-background-border); padding: 2px 6px; border-radius: 0px;">KNOB</span> is the corresponding value of the relevant crossing angle knob.
 
 ## Running the Analysis
 
-<span class="guilabel" style="--guilabel-bg: green;">Run Analysis</span>: Runs the analysis on the provided data (i.e. collating crossing angle knob values and the RDT values), and displays the output files in the GUI on the [Validation](validation.md){.tab-link} tab.
+<span class="rdtfeeddown_guilabel" style="--rdtfeeddown_guilabel-bg: green;">Run Analysis</span>: Runs the analysis on the provided data (i.e. collating crossing angle knob values and the RDT values), and displays a list of the output files in the GUI on the [Validation](validation.md){.rdtfeeddown_tab-link} tab.
 
 ## Other Features
 
-- <span class="guilabel">Validate Knob</span>: <span class="warning-colored">Not required</span> unless you want to check that the crossing angle knob name exists in the `Timber` database for the measurement.
+- <span class="rdtfeeddown_guilabel">Validate Knob</span>: <span class="warning-colored">Not required</span> unless you want to check that the crossing angle knob name exists in the `Timber` database for the measurement.
+
+    [omc_homepage]: https://pylhc.github.io/packages/omc3/about.html
diff --git a/docs/guis/rdt_feeddown/validation.md b/docs/guis/rdt_feeddown/validation.md
@@ -7,17 +7,17 @@
   </center>
 </figure>
 
-The [Validation](validation.md){.tab-link} tab of the GUI provides a way to load data in the format created by the [Input](input.md){.tab-link} tab, and display it to validate it.
+The [Validation](validation.md){.rdtfeeddown_tab-link} tab of the GUI provides a way to load data in the format created by the [Input](input.md){.rdtfeeddown_tab-link} tab, and display it to validate it.
 
 ## Input Fields Explained
 
-- <span class="guilabel">Add Files</span>: Add the generated files from the [Input](input.md){.tab-link} tab of the GUI containing the RDT data you want to plot (this simply adds the filenames to a list).
-- <span class="guilabel">Load Selected Files for Plotting</span>: Load the selected files to display their data in the plotting tabs (this then checks that the files are compatible to be plotted together). The loaded files will be displayed in the box below the button.
+- <span class="rdtfeeddown_guilabel">Add Files</span>: Add the generated files from the [Input](input.md){.rdtfeeddown_tab-link} tab of the GUI containing the RDT data you want to plot (this simply adds the filenames to a list for easy access).
+- <span class="rdtfeeddown_guilabel">Load Selected Files for Plotting</span>: Load the selected files to display their data in the plotting tabs (this then checks that the files are compatible to be plotted together). The loaded files will be displayed in the box below the button.
 
 ## Plotting Tabs Explained
 
 !!! warning
-    Ignore the error message below for both the [RDT](#__tabbed_1_2){.tab-link} and [RDT shift](#__tabbed_1_3){.tab-link} tab, if you only have RDT data from one beam loaded (in this example it would only be LHCB1 data) - this should not affect the plotting.
+    Ignore the error message below for both the [RDT](#__tabbed_1_2){.rdtfeeddown_tab-link} and [RDT shift](#__tabbed_1_3){.rdtfeeddown_tab-link} tab, if you only have RDT data from one beam loaded (in this example it would only be LHCB1 data) - this should not affect the plotting.
 
     ```text
     Error accessing LHCB2 RDT data: 'NoneType' object is not subscriptable
@@ -35,10 +35,10 @@ The [Validation](validation.md){.tab-link} tab of the GUI provides a way to load
 
     This tab displays the RDT as a function of crossing angle for a BPM of your choice.
 
-    !!! tip
-        You can search for a BPM by typing its name in the search box and pressing the <span class="guilabel">Search BPM</span> button. This just checks if the BPM exists in the list of BPMs. 
+    !!! tip "Searching for BPMs Tip"
+        You can search for a BPM by typing its name in the search box and pressing the <span class="rdtfeeddown_guilabel">Search BPM</span> button. This just checks if the BPM exists in the list of BPMs. 
         
-    Either pressing <kbd>Enter</kbd> or <span class="guilabel" style="--guilabel-bg: #5C62D6;">Plot BPM</span> will plot the RDT at that BPM as a function of crossing angle.
+    Either pressing <kbd>Enter</kbd> or <span class="rdtfeeddown_guilabel" style="--rdtfeeddown_guilabel-bg: #5C62D6;">Plot BPM</span> will plot the RDT at that BPM as a function of crossing angle.
 
 === "RDT"
 
@@ -49,7 +49,7 @@ The [Validation](validation.md){.tab-link} tab of the GUI provides a way to load
     </center>
     </figure>
 
-    This tab displays the RDT as a function of position *s* for all crossing angles when <span class="guilabel" style="--guilabel-bg: #5C62D6;">Plot RDT</span> is pressed.
+    This tab displays the RDT as a function of position *s* for all crossing angles when <span class="rdtfeeddown_guilabel" style="--rdtfeeddown_guilabel-bg: #5C62D6;">Plot RDT</span> is pressed.
 
 === "RDT shift"
 
@@ -60,6 +60,6 @@ The [Validation](validation.md){.tab-link} tab of the GUI provides a way to load
     </center>
     </figure>
 
-    This tab displays the average RDT shift as a function of crossing angle when <span class="guilabel" style="--guilabel-bg: #5C62D6;">Plot RDT shifts</span> is pressed.
+    This tab displays the average RDT shift as a function of crossing angle when <span class="rdtfeeddown_guilabel" style="--rdtfeeddown_guilabel-bg: #5C62D6;">Plot RDT shifts</span> is pressed.
 
 
