Index: src/Common/Stats.h
===================================================================
--- src/Common/Stats.h	(revision 1cb7fab24a9d8ae701d8295e3857478969f5fd45)
+++ src/Common/Stats.h	(revision 1bb9a9a31ea68de9c74a5cd408849eadfdf24745)
@@ -16,4 +16,28 @@
 #pragma once
 
+// Entry point for compiler analytics.
+/*
+The compiler currently supports 3 times of analytics:
+	 - generic counters
+	 - heap statistics
+	 - timiing statistics
+
+These can be enabled using the --stats option, to which a comma seperated list of options can be passed.
+For more details see Stats.cc
+
+Counters:
+	The counters are a generic tree of counters that print in a 2-column output format.
+	They can count maximums, averages, totals, etc.
+
+	Currently all counters are under the same enable block, this could be changed if needed.
+
+Heap:
+	Measures the total calls malloc and free as the peak number of allocations per pass
+
+Timing:
+	Comming soon
+*/
+
+
 #include "Common/Stats/Counter.h"
 #include "Common/Stats/Heap.h"