This directory contains various design documents used to specify intended features before they are implemented.
Some of these features end up differently than what's described in the design documents, but they can serve as a good background to why some things behave as they do.