added punycode considerations to the API docs