extend type conversions and update readme