docs: Attempts to make README a bit more readable
docs: Attempts to make README a bit more readable

Adds comments describing functions at the far right, making the
separation of code and docs a bit more readable.

Also adds info on the 'with_data' construct.

joakimkarlsson/describe_it