optimize the getItems method + some docs tweaks