add ref to intro from paths
update examples based upon more feedback from Barry