fix installation of examples
tidy up and add XXX to remind me to work on building docs