doc improvments thanks to tablespoon