documentation and additions