Add some documentation to help explain #373