docs to address #5