skip invalid rowkeys, fix error converting gstring
add additional documentation for future reference