add a few more examples & explanatory comments