Documentation: examples could use a readme file

[geoidesic]

Hi there,
This repo has a good reputation. I'm trying to learn it. The examples could really benefit from a readme file that explains the intention. There are no comments in the examples so it's impossible (for me) to understand what the three files represent or what to do with them.

[tunnckoCore]

Definitely, we are working on better docs.
I'm for the docs and tests part here, others are for the bugs and code ;d

Thanks for the report.

@xarguments, please add docs label when you can.