Document some implementation details, for the curious... :)