diff --git a/doc/noise.asc b/doc/noise.asc
new file mode 100644
index 00000000..3575c515
--- /dev/null
+++ b/doc/noise.asc
@@ -0,0 +1,48 @@
+== noise
+
+=== fractals
+
+fbm:: fractional brownian motion. simple summation of successive basis iterations with geometrically varying amplitude and frequency. results in homogenous and isotropic fields.
+hetero:: heterogenous fractal terrain. dampens high frequency contributions at local minima 
+rmf::
+hmf::
+
+runtime::
+
+==== fractional brownian motion (fbm)
+
+==== hetergenous fractal terrain
+
+==== ridged multi-fractal
+
+==== hybrid multi-fractal
+
+=== parameters
+
+octaves::
+
+H:: fractal hurst parameter.
+
+amplitude::
+gain::
+
+frequency::
+lacunarity::
+
+
+=== basis
+
+worley::
+perlin::
+value::
+patch::
+constant::
+
+=== lerp
+
+linear::
+cubic::
+quintic::
+cosine::
+
+=== turbulence