added apache 2.0 licence
added readme and greatly extended documentation of the worked examples