add changelog for 0.5 and some extended documentation


Some more doc. Based on issues of our users.