add a few documentation improvements; add how to compile the examples with cmake