This should be explained a bit in the class doc with maybe a link to a reference