documentation to prevent a regression