more documentation including inserts and search