Add `locale` format in the messaging API documentation

Background

See current discussion.

What to change

Add information about the locale format here.