documentation improvements

- some documentation fixes and improvements
- missing caution.png icon. I've tried to match the style of the remaining icons