better/up-to-date examples and outline