extend readme regarding referencing external classes and add a small example

A bunch of small doc/example updates as requested in Issue #1