Index: docs/Benchmarking.rst
===================================================================
--- /dev/null
+++ docs/Benchmarking.rst
@@ -0,0 +1,59 @@
+==================================
+Benchmarking tips
+==================================
+
+
+Introduction
+============
+
+For benchmarking a patch we want to be in control of all the possible sources of noise. How to do that is very OS dependent.
+
+Linux
+================================
+
+* Static link. That avoids any variation that might be introduced by
+  loading dynamic libraries. This can be done by passing
+  ``-DLLVM_BUILD_STATIC=ON`` to cmake.
+
+* Use tmpfs for all the parts. Putting the program, inputs and outputs
+  on tmpfs avoids touching a real storage system, which can have a
+  pretty big variability.
+
+  To mount it::
+
+    mount -t tmpfs -o size=<XX>g none dir_to_mount
+
+* Disable address space randomization::
+
+    echo 0 > /proc/sys/kernel/randomize_va_space
+
+* Disable turbo mode::
+
+    echo 1 > /sys/devices/system/cpu/intel_pstate/no_turbo
+
+* Set scaling_governor to performance::
+
+   for i in /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor
+   do
+     echo performance > /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor
+   done
+
+* Use https://github.com/lpechacek/cpuset to reserve cpus for just the
+  program you are benchmarking. If using perf, leave at least 2 cores
+  so that perf runs in one and your program in another::
+
+    cset shield -c N1,N2 -k on
+
+* Disable the SMP pair of the cpus you will use for the benchmark. The
+  pair of cpu N can be found in
+  ``/sys/devices/system/cpu/cpuN/topology/thread_siblings_list`` and
+  disabled with::
+
+    echo 0 > /sys/devices/system/cpu/cpuX/online
+
+
+* Run the program with::
+
+    cset shield --exec -- perf stat -r 10 <cmd>
+
+With these in place you can expect perf variations of less than 0.1%.
Index: docs/index.rst
===================================================================
--- docs/index.rst
+++ docs/index.rst
@@ -90,6 +90,7 @@
    CodeOfConduct
    CompileCudaWithLLVM
    ReportingGuide
+   Benchmarking
 
 :doc:`GettingStarted`
    Discusses how to get up and running quickly with the LLVM infrastructure.