added a few implementation notes