added more documentation about the hack to flush the treeitems cache