documentation: table improvements