diff --git a/.gitignore b/.gitignore
index fdb56b6318bc9a53add69d3ede021a48c85bb0ff..65910c3bca9862cfe2d2daf87a1f4d1ec17b0cd0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,3 +6,4 @@ docs/_build/
 
 # IDE
 .project
+.vscode
diff --git a/docs/overview.rst b/docs/overview.rst
index 196132fd8856e78fd744a25cd62407bf4c181852..02407a0b5138104347b830b58244bf99300ccb30 100644
--- a/docs/overview.rst
+++ b/docs/overview.rst
@@ -16,4 +16,6 @@ The A1 Simulator terminates the A1 interface and provides a way of testing servi
 Near |nbh| RT |nbsp| RICs.
 
 Apart from providing the A1 API, the simulator also provides an administrative API to manage policy types and manipulate
-the simulator, see ":ref:`simulator-api`".
\ No newline at end of file
+the simulator, see ":ref:`simulator-api`".
+
+For information on how to run the simulator, see the README.md file in the repository.
\ No newline at end of file
diff --git a/near-rt-ric-simulator/README.md b/near-rt-ric-simulator/README.md
index 1c2cca76478b0330aed329ba6bfb1143fef7f38a..36199d84caee78eb44c8141b655d8fd69b734b05 100644
--- a/near-rt-ric-simulator/README.md
+++ b/near-rt-ric-simulator/README.md
@@ -22,11 +22,14 @@ The overall folder structure is \(relative to the location of this README file\)
 
 The simulator handles the requests that are defined in the A1 open API yaml file. All these requests are implemented in the a1.py file in the source folder. In addition, a number of administrative functions are also supported and implemented by the main.py in the source folder.
 
-The section below outlines the supported open api REST operations as well as the adminstrative REST operations.
+The section below outlines the supported open api REST operations as well as the adminstrative REST operations. For the
+documentation of the common parts in the admin API, see [Common Functions](https://docs.o-ran-sc.org/projects/o-ran-sc-sim-a1-interface/en/latest/simulator-api.html#common-functions).
 
 
 # Supported operations in simulator OSC 2.1.0
 
+For the complete yaml specification, see [openapi.yaml](../near-rt-ric-simulator/api/OSC_2.1.0/openapi.yaml).
+
 URIs for A1:
 | Function              | Path and parameters |
 | --------------------- | ------------------- |
@@ -43,6 +46,8 @@ URIs for A1:
 
 Swagger UI at: http://localhost:8085/ui/
 
+For the documentation of the admin API, see [OSC_2.1.0](https://docs.o-ran-sc.org/projects/o-ran-sc-sim-a1-interface/en/latest/simulator-api.html#osc-2-1-0).
+
 URIs for admin operations:
 | Function              | Path and parameters |
 | --------------------- | ------------------- |
@@ -61,6 +66,8 @@ URIs for admin operations:
 
 # Supported operations in simulator A1 Standard 1.1.3
 
+For the complete yaml specification, see [STD_A1.yaml](../near-rt-ric-simulator/api/STD_1.1.3/STD_A1.yaml).
+
 URIs for A1:
 | Function              | Path and parameters |
 | --------------------- | ------------------- |
@@ -71,6 +78,8 @@ URIs for A1:
 |  GET a policy status | http://localhost:8085/A1-P/v1/policies/{policyid} |
 Swagger UI at: http://localhost:8085/A1-P/v1/ui/
 
+For the documentation of the admin API, see [A1 Standard 1.1.3](https://docs.o-ran-sc.org/projects/o-ran-sc-sim-a1-interface/en/latest/simulator-api.html#a1-standard-1-1-3).
+
 URIs for admin operations:
 | Function              | Path and parameters |
 | --------------------- | ------------------- |
@@ -88,7 +97,9 @@ URIs for admin operations:
 
 # Supported operations in simulator 1.1.x-alpha.2
 
- The available requests and the addresses are currently:
+For the complete yaml specification, see [a1-openapi.yaml](../near-rt-ric-simulator/api/1.1.x-alpha.2/a1-openapi.yaml).
+
+The available requests and the addresses are currently:
 | Function              | Path and parameters |
 | --------------------- | ------------------- |
 |  GET all policy identities (respectively for a policy type if query parameter used) | http://localhost:8085/A1-P/v1/policies?policyTypeId={policyTypeId} |
@@ -101,6 +112,8 @@ URIs for admin operations:
 
 Nota Bene: It could happen that this page is not updated as soon as the yaml file is. The yaml file can be found under /near-rt-ric-simulator/a1-openapi.yaml.
 
+For the documentation of the admin API, see [1.1.x-alpha.2](https://docs.o-ran-sc.org/projects/o-ran-sc-sim-a1-interface/en/latest/simulator-api.html#x-alpha-2).
+
 Additionally, there are requests that are defined in main.py as an administrative API. The goal is to handle information that couldn't be handled using the A1 interface. The available requests and the addresses are currently:
 | Function              | Path and parameters |
 | --------------------- | ------------------- |