added implementation notes and some code comments