improve safety documentation in the reference