add docs, all CRUD methods and improve searching