adding some comments/examples re resources #20