First version of the readme document.

Review by @gzm0 @hubertp
"using macros" rather than "as a macro" (we use more then one, don't we :P)