improved comments in preperation for 'more' improvments