Adds more examples

examples/README.md

@@ -1,12 +1,13 @@
 ## Examples
 
 All dependencies to run the examples are installed into the Rasqal venv if you are building normally.
-If you can't run the full build, use `./bulid.ps1 -t "initialize-examples"` to install a Rasqal versio from pypi as a replacement.
+If you can't run the full build, use `./bulid.ps1 -t "initialize-examples"` to install a Rasqal version from pypi as a replacement.
 
 All files can be run directly.
 
-**Examples.py** holds examples of how to use Rasqals Python APIs to run QIR.
+Note: all our examples are built using the old Q# compiler as Rasqal can exploit its fully interwoven classical LLVM instructions. If you want to experiment with its full capabailities it's recommended you do the same.
 
-**Sandbox.py** runs the sandbox Q# project in `qsharp/src`.
-Modify the project as you need and then run the Python file to see how Rasqal reacts.
-Currently restricted to adaptive profile QIR.
+**Examples.py** holds runnable examples of many of Rasqals internal test projects showing how you set up and run things, including backend and argument definition. Shows the Q# that the QIR was generated from for each example, along with tertiary information. 
+Source for most examples can be found in `src/tests/qsharp` and can be modified from there and re-built. 
+
+**Sandbox.py** runs the sandbox Q# project in `qsharp/src`. This uses the new Q# compiler so instruction set is limited.