Documents refactor

docs/quick_start/circuits/API/qasm2 core.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/circuits/API/qasm2 inline.md

@@ -0,0 +1,6 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.
+
+?? Merge with qasm2 core API to cut down on pages?

docs/quick_start/circuits/API/qasm2 noise.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/circuits/API/qasm2 parallel.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/circuits/API/qasm2 uop.md

@@ -0,0 +1,6 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.
+
+?? Merge with qasm2 core API to cut down on pages?

docs/quick_start/circuits/compiler_passes/asap_parallelism.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/circuits/compiler_passes/circuit_simplification.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/circuits/compiler_passes/index.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/circuits/compiler_passes/native_gate_rewrite.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/digital/qasm2.md → docs/quick_start/circuits/index.md

@@ -1,3 +1,22 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.
+
+# Digital Quantum Computing
+
+This section provides the quick start guide for programming digital quantum circuits using Bloqade.
+
+
+## Open Quantum Assembly Language (QASM2)
+
+Bloqade provides a set of dialects for QASM2 and our custom extensions to model parallel gates in neutral atom architectures. The QASM2 dialect is a simple quantum assembly language that allows you to write quantum circuits in a human-readable format. However, one should note that QASM2 is a very restricted language and does not support all the features of a high-level language.
+
+For example, there is a separation of **gate routines** declared with `gate` and main program written as a sequence of gate applications. While the gate routine is similar to a function in many ways, it does not support high-level features such as recursions (due to lack of `if` statement support inside) or control flows.
+
+While in our initial release, we support QASM2 as the first eDSL, we plan to use it as a compile target instead of a programming language for long-term development. We are working on a more expressive language that will be more suitable for quantum programming at error-corrected era.
+
+
 !!! warning
     This page is under construction. The content may be incomplete or incorrect. Submit an issue
     on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
@@ -145,8 +164,4 @@ measure q[0] -> c[0];
 measure q[1] -> c[1];
 ```
 
-Note that the `return` values are all ignore due to lack of equivalent in QASM2.
-
-## API Reference
-
-::: bloqade.qasm2
+Note that the `return` values are all ignore due to lack of equivalent in QASM2.

docs/quick_start/circuits/interpreters_and_analysis/index.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/circuits/interpreters_and_analysis/pyqrack_emulator.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/circuits/interpreters_and_analysis/qasm2_codegen.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

docs/quick_start/qourier/index.md

@@ -0,0 +1,6 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.
+
+Hardware level moves. Included as an example "extra" dialect set. !! To be removed before open open source !!

docs/vision.md

@@ -0,0 +1,4 @@
+!!! warning
+    This page is under construction. The content may be incomplete or incorrect. Submit an issue
+    on [GitHub](https://github.com/QuEraComputing/bloqade/issues/new) if you need help or want to
+    contribute.

mkdocs.yml

@@ -12,20 +12,43 @@ nav:
       - index.md
       - Installation: install.md
       - Background: background.md
+      - Vision: vision.md
       - Quick Start:
-        - Digital:
-          - quick_start/digital/index.md
-          - QASM2: quick_start/digital/qasm2.md
+        - Circuits: 
+          - quick_start/circuits/index.md
+          - Examples:
+            - Quantum Fourier Transform: "digital/examples/qft.py"
+            - GHZ state preparation: "digital/examples/ghz.py"
+            - Pauli Exponential: "digital/examples/pauli_exponentiation.py"
+            - Repeat Until Success: "digital/examples/repeat_until_success.py"
+            - QAOA: "digital/examples/qaoa.py"
+          - Compiler passes:
+            - quick_start/circuits/compiler_passes/index.md
+            - Native gate rewrite: quick_start/circuits/compiler_passes/native_gate_rewrite.md
+            - ASAP Parallelism: quick_start/circuits/compiler_passes/asap_parallelism.md
+            - Circuit simplification: quick_start/circuits/compiler_passes/circuit_simplification.md
+          - Interpreters and analysis:
+            - quick_start/circuits/interpreters_and_analysis/index.md
+            - QASM2 Codegen: quick_start/circuits/interpreters_and_analysis/qasm2_codegen.md
+            - PyQrack emulator: quick_start/circuits/interpreters_and_analysis/pyqrack_emulator.md
+          - Circuit dialect API:
+            - QASM2 Core: quick_start/circuits/API/qasm2 core.md
+            - QASM2 Noise: quick_start/circuits/API/qasm2 noise.md
+            - QASM2 Parallel: quick_start/circuits/API/qasm2 parallel.md
+            - QASM2 Uop: quick_start/circuits/API/qasm2 uop.md
         - Analog:
           - quick_start/analog/index.md
+        - Qourier:
+          - quick_start/qourier/index.md
       - Contributing: contrib.md
   - Digital Tutorial:
     - digital/index.md
-    - Quantum Fourier Transform: "digital/examples/qft.py"
-    - GHZ state preparation: "digital/examples/ghz.py"
-    - Pauli Exponential: "digital/examples/pauli_exponentiation.py"
-    - Repeat Until Success: "digital/examples/repeat_until_success.py"
-    - QAOA: "digital/examples/qaoa.py"
+    - Circuits:
+      - Quantum Fourier Transform: "digital/examples/qft.py"
+      - GHZ state preparation: "digital/examples/ghz.py"
+      - Pauli Exponential: "digital/examples/pauli_exponentiation.py"
+      - Repeat Until Success: "digital/examples/repeat_until_success.py"
+      - QAOA: "digital/examples/qaoa.py"
   - Analog Tutorial: 'https://queracomputing.github.io/bloqade-python/latest/'
   - Blog:
     - blog/index.md