This directory contains some high level documentation for the code.  We should strive to keep it up-to-date, but don't take it as the absolute truth.

A good place to start is 'overview.md'