diff --git a/qaoa/README.md b/qaoa/README.md
new file mode 100644
index 00000000..73a54e65
--- /dev/null
+++ b/qaoa/README.md
@@ -0,0 +1,14 @@
+# Files
+
+
+- `Node_parallelism.(py|ipynb)`: measure performance of single-node parallelism
+- `Graph parallelism.(py|ipynb)`: measure performance of whole parallel graph contraction.
+- `test_parallel_qaoa_sim.py`: entry point used for simulations.
+
+
+## Qtree
+
+https://pypi.org/project/qtree/
+
+
+