diff --git a/devtools/architecture/Lattice.md b/devtools/architecture/Lattice.md
new file mode 100644
index 0000000000000000000000000000000000000000..41910b4fd557a578ce2cf6f0dafff62580c8815f
--- /dev/null
+++ b/devtools/architecture/Lattice.md
@@ -0,0 +1,12 @@
+## Lattices
+
+Typical sample construction with a 3d lattice:
+```
+    lattice = ba.FCCLattice(30*nm).transformed(rot.getTransform3D())
+    peak_shape = ba.MisesFisherGaussPeakShape(peak_intensity, peak_width, zenith, kappa, kappa2)
+    iff = ba.InterferenceFunction3DLattice(lattice)
+    iff.setPositionVariance(1.)
+    iff.setPeakShape(peak_shape)
+```
+
+`bake::FCCLattice` returns a `Lattice3d` with an fcc primitive cell.