add some documentary comments