Add more documentation, including examples

[lpil]

Hello!

The documentation at the moment is very sparse so it's hard to know what the different parsing and formatting functions do. It would be fab if there was more documentation, including examples and explanations of the different formats.

Thanks, Louis

[massivefermion]

Thanks for the issue. I think the new version addresses this adequately.