fix item insertion, update docs