minor documentation and utils updates