add some documentation on the formating rules.
rearrange the conversion tests, so its easier to follow.