more informative parameter descriptions; read name conventions