simplifications and improvements in section 3
add caution.png icon
Merge pull request #122 from norbertpotocki/doc-fixes

documentation improvements