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'