add docs and change confusing naming of types and formats

[FRoith]

documentation is in tomlspec.md, looking for feedback on the quality, ie what is unclear and can be improved

also changed the confusing naming scheme of the "type" and "types" section to "types" and "formats"