clarifications
better info
uniform format. fixes #1