very explicit commenting of hashUIDx
more comments based on tests
add file path parsing