improved documentation

now with tables