Better docs and example name changed

Author: DOKOS-TAYOS

README.md

@@ -94,9 +94,19 @@ plot_tensornetwork_network_2d([node1, node2, node3])
 plot_tensornetwork_network_3d([node1, node2, node3])
 ```
 
+## Internal architecture
+
+The public API is split by backend, but the render pipeline is now shared:
+
+- `tensor_network_viz._core` contains the normalized graph model, layout, curve geometry, drawing, and shared renderer.
+- `tensor_network_viz.tensorkrowch` contains the TensorKrowch adapter that converts TensorKrowch inputs into the shared graph model.
+- `tensor_network_viz.tensornetwork` contains the TensorNetwork adapter that converts TensorNetwork node collections into the shared graph model.
+
+This means TensorKrowch and TensorNetwork are not converted into each other. Each backend normalizes its own input to the common `_GraphData` structure and the shared core handles the rest.
+
 ## Project layout
 
-- `examples/` - Demo scripts. Run `python examples/tensor_network_demo.py mps 2d` for TensorKrowch or `python examples/tensornetwork_demo.py mps 2d` for TensorNetwork.
+- `examples/` - Demo scripts. Run `python examples/tensorkrowch_demo.py mps 2d` for TensorKrowch or `python examples/tensornetwork_demo.py mps 2d` for TensorNetwork.
 - `scripts/` - Utility scripts (for example `clean.py` to remove caches and build artifacts).
 
 ## Development

examples/README.md

@@ -2,13 +2,13 @@
 
 Run from the project root (with venv activated or `python` from `.venv`).
 
-## tensor_network_demo.py
+## tensorkrowch_demo.py
 
 ```bash
-python examples/tensor_network_demo.py mps 2d
-python examples/tensor_network_demo.py weird 3d
-python examples/tensor_network_demo.py disconnected 2d
-python examples/tensor_network_demo.py mps 2d --from-list
+python examples/tensorkrowch_demo.py mps 2d
+python examples/tensorkrowch_demo.py weird 3d
+python examples/tensorkrowch_demo.py disconnected 2d
+python examples/tensorkrowch_demo.py mps 2d --from-list
 ```
 
 - **Networks:** `disconnected`, `mps`, `mpo`, `peps`, `weird`
@@ -30,6 +30,12 @@ python examples/tensornetwork_demo.py mps 2d --save mps.png --no-show
 - **`--save PATH`:** Save the rendered figure
 - **`--no-show`:** Do not open the interactive Matplotlib window
 
+## Architecture note
+
+- `tensor_network_viz._core`: Common graph, layout, drawing, and rendering pipeline
+- `tensor_network_viz.tensorkrowch`: TensorKrowch-specific input adapter plus public helpers
+- `tensor_network_viz.tensornetwork`: TensorNetwork-specific input adapter plus public helpers
+
 ## tn_tsp.py
 
 TSP tensor network visualization (step 0, before contraction).

examples/tensor_network_demo.py examples/tensorkrowch_demo.pyexamples/tensor_network_demo.py renamed to examples/tensorkrowch_demo.py

@@ -27,10 +27,10 @@
   - disconnected
 
 Examples:
-  python examples/tensor_network_demo.py mps 2d
-  python examples/tensor_network_demo.py weird 3d
-  python examples/tensor_network_demo.py mps 2d --from-list
-  python examples/tensor_network_demo.py disconnected 2d
+  python examples/tensorkrowch_demo.py mps 2d
+  python examples/tensorkrowch_demo.py weird 3d
+  python examples/tensorkrowch_demo.py mps 2d --from-list
+  python examples/tensorkrowch_demo.py disconnected 2d
 """