docs rework, table redone