Merge branch 'main' into david/move-analog-docs

Author: david-pl

docs/digital/cirq_interop/index.md

@@ -10,7 +10,7 @@ For details on each of these, please see the documentation pages below:
 * [Obtaining a squin kernel function from a `cirq.Circuit`](./cirq_to_squin.md)
 * [Emitting a `cirq.Circuit` from a squin kernel](./squin_to_cirq.md)
 
-For the API reference, please see the `cirq` submodule in the [squin API docs](../../reference/squin.md).
+For the API reference, please see the `cirq` submodule in the [squin API docs](../../reference/bloqade-circuit/src/bloqade/squin.md).
 
 ## TL;DR
 

docs/digital/dialects_and_kernels.md

@@ -2,7 +2,7 @@
 
 Bloqade provides a set of pre-defined dialects, with which you can write your programs and circuits.
 
-Once you have your kernel, you can inspect their intermediate representation (IR), apply different optimizations using [compiler passes](../quick_start/circuits/compiler_passes/index.md), or run them on a [(simulator) device](./simulator_device/simulator_device.md).
+Once you have defined your kernel, you can inspect their intermediate representation (IR), apply different optimizations using [compiler passes](../quick_start/circuits/compiler_passes/index.md), or run them on a [(simulator) device](./simulator_device/simulator_device.md).
 
 !!! info
     A **kernel** function is a piece of code that runs on specialized hardware such as a quantum computer.
@@ -43,7 +43,7 @@ Here's a quick overview of the most important available dialects.
 ## qasm2
 
 There are a number of dialects with which you can write kernels that represent QASM2 programs.
-See also the [qasm2 API reference](../reference/qasm2.md)
+See also the [qasm2 API reference](../../reference/bloqade-circuit/src/bloqade/qasm2/)
 
 ### qasm2.main
 
@@ -205,11 +205,11 @@ def main():
 main.print()
 ```
 
-See also the [squin API reference](../reference/squin.md)
+See also the [squin API reference](../../reference/bloqade-circuit/src/bloqade/squin/)
 
 ## stim
 
 !!! warning
     Sorry folks, still under construction.
 
-See also the [stim API reference](../reference/stim.md)
+See also the [stim API reference](../../reference/bloqade-circuit/src/bloqade/stim/)

docs/digital/examples/interop/noisy_ghz.py

@@ -41,10 +41,10 @@
 # ## Noise model implementations
 #
 # For now, these noise models are implemented as [`cirq.NoiseModel`](https://quantumai.google/reference/python/cirq/NoiseModel) classes, so that you can use with any circuit you build using `cirq`.
-# They are part of the [`bloqade.cirq_utils`](../../../reference/cirq_utils) submodule.
+# They are part of the [`bloqade.cirq_utils`](../../../../reference/bloqade-circuit/src/bloqade/cirq_utils) submodule.
 #
-# Support for using these models with e.g. [squin](../dialects_and_kernels.md) will follow in the future.
-# However, you can already rely on [interoperability with cirq](../cirq_interop) in order to convert (noisy) circuits to squin kernels and use other parts of the compiler pipeline.
+# Support for using these models with e.g. [squin](../../../dialects_and_kernels) will follow in the future.
+# However, you can already rely on [interoperability with cirq](../../../cirq_interop) in order to convert (noisy) circuits to squin kernels and use other parts of the compiler pipeline.
 
 # %% [markdown]
 # ## GHZ preparation and noise
@@ -190,7 +190,7 @@ def ghz_circuit(n: int) -> cirq.Circuit:
 # Whereas, in the two-zone model, qubits are moved between the gate and storage zones.
 #
 # You could now think about how to optimize the circuits in order to reduce their sensitivity for noise.
-# For example, you can [reduce the circuit depth](../ghz)
+# For example, you can [reduce the circuit depth](../../qasm2/ghz)
 
 # %% [markdown]
 # ### Modifying the noise
@@ -214,7 +214,7 @@ def ghz_circuit(n: int) -> cirq.Circuit:
 #
 # The noise processes are further split into local and global noise channels and separated by their cause.
 #
-# For a full list of noise parameters and a description of each one, please refer to the move noise model in [`bloqade.qasm2.dialects.noise.model.MoveNoiseModelABC`](../../../reference/qasm2/#bloqade.qasm2.dialects.noise.model.MoveNoiseModelABC)
+# For a full list of noise parameters and a description of each one, please refer to the move noise model in [`bloqade.qasm2.dialects.noise.model.MoveNoiseModelABC`](../../../../reference/bloqade-circuit/src/bloqade/qasm2/dialects/noise/model#MoveNoiseModelABC)
 #
 # We can use those parameters in order to modify the strength of the noise.
 #

docs/digital/index.md

@@ -15,7 +15,7 @@ The infrastructure behind these compilers is built on top of [Kirin](https://que
 It is easiest to learn how to use this package by checking out the [examples & tutorials section](tutorials_index.md), where we show how you can build and study different quantum programs written in different DSLs.
 You can also find the corresponding scripts in [jupytext format](https://jupytext.readthedocs.io/en/latest/) at the [bloqade repository](https://github.com/QuEraComputing/bloqade) under `docs/digital/examples/`.
 
-Finally, if you want the full details on the API, please refer to the [API reference documentation](../reference/).
+Finally, if you want the full details on the API, please refer to the [API reference documentation](../../reference/bloqade-circuit/src/bloqade/device/).
 
 ## Installation
 
@@ -42,7 +42,7 @@ pip install bloqade-circuit[cirq,qasm2,stim]
 
 ## TL;DR
 
-Here's a GHZ preparation circuit written in the [`squin`](../reference/squin.md) dialect:
+Here's a GHZ preparation circuit written in the [`squin`](../../reference/bloqade-circuit/src/bloqade/squin/) dialect:
 
 ```python
 from bloqade import squin

docs/digital/simulator_device/tasks.md

@@ -3,4 +3,4 @@
 !!! warning
     Sorry folks, still under construction.
 
-For now, please check the [API reference](../../reference/task.md).
+For now, please check the [API reference](../../reference/bloqade-circuit/src/bloqade/task.md).