table: improve deletetion
documentation: add documentation and specs