- added short doc on how this works