add some doc/notes regarding performance