Merge branch 'doc-sa-use' into 'develop' (!3113)

Reformulate section on standalone mode

Clarifications on when (or if) to use --sa

doc/NR_SA_Tutorial_COTS_UE.md

@@ -103,6 +103,10 @@ docker compose up -d
 
 ## 4.2 Run OAI gNB
 
+**Note:** From tag `2024.w45`, OAI gNB runs by default in standalone (SA) mode.  
+In earlier versions the default mode was non-standalone (NSA).  
+If you are using an earlier version than `2024.w45`, you should add the `--sa` argument to the sample commands below to obtain a correct behavior.
+
 ### USRP B210
 ```bash
 cd ~/openairinterface5g/cmake_targets/ran_build/build

doc/NR_SA_Tutorial_OAI_nrUE.md

@@ -94,6 +94,10 @@ docker compose up -d
 
 ## 4.2 Run OAI gNB
 
+**Note:** From tag `2024.w45`, OAI gNB runs by default in standalone (SA) mode.  
+In earlier versions the default mode was non-standalone (NSA).  
+If you are using an earlier version than `2024.w45`, you should add the `--sa` argument to the sample commands below to obtain a correct behavior.
+
 ### USRP B210
 ```bash
 cd ~/openairinterface5g/cmake_targets/ran_build/build
@@ -126,6 +130,11 @@ sudo ./nr-softmodem -O ../../../targets/PROJECTS/GENERIC-NR-5GC/CONF/gnb.sa.band
 # 5. OAI UE
 
 ## 5.1 Run OAI nrUE
+
+**Note:** From tag `2024.w45`, OAI nrUE runs by default in standalone (SA) mode.  
+In earlier versions the default mode was non-standalone (NSA).  
+If you are using an earlier version than `2024.w45`, you should add the `--sa` argument to the sample commands below to obtain a correct behavior.
+
 ### USRP B210
 Important notes:
 - This should be run in a second Ubuntu 22.04 host, other than gNB
@@ -194,6 +203,10 @@ The CL option `--uicc0.imsi`  can override the IMSI value in the configuration f
 
 More details available at [ci-scripts/yaml_files/5g_rfsimulator/README.md](../ci-scripts/yaml_files/5g_rfsimulator/README.md).
 
+**Note:** From tag `2024.w45`, OAI nrUE runs by default in standalone (SA) mode.  
+In earlier versions the default mode was non-standalone (NSA).  
+If you are using an earlier version than `2024.w45`, you should add the `--sa` argument to the sample commands above to obtain a correct behavior.
+
 ## 5.2 End-to-end connectivity test
 - Ping test from the UE host to the CN5G
 ```bash

doc/README.md

@@ -12,6 +12,15 @@
   </tr>
 </table>
 
+This is the general overview page of the OpenAirInterface documentation.  
+This page groups links to general information, tutorials, design documents, radio integration, and special-purpose libraries.
+
+**IMPORTANT NOTE:**  
+Before reading this documentation, we strongly advise you to keep your own repository rebased on `develop`
+or at least to checkout the documentation on the version of the repository you are using.  
+Then the documentation will better reflect the features available in your repository so that you may avoid some errors.  
+Beware if you previously pulled the `develop` branch that your repository may be now behind `develop`.
+
 [[_TOC_]]
 
 # General

doc/RUNMODEM.md

@@ -83,7 +83,12 @@ You should see the X2 messages in Wireshark and at the eNB.
 
 The standalone mode is the default mode. 
 
-It is not necessary to run either the gNB or the UE using the `--sa` flag in the command line for standalone mode.
+Before tag `2024.w45`, the default mode was NSA. Thus, in the past, to run
+either the gNB or the UE in standalone mode, it was necessary to provide the
+`--sa` flag in the command line. This is not necessary anymore; if in doubt,
+you can provide `--sa` on the command line. The gNB will ignore this option if
+not relevant; the UE might complain that it does not know this option, which
+means that standalone is already active.
 
 The default (SA) mode does the following:
 - At the gNB: