updated examples; added outline