integrate better with java.util.UUID and improve documentation