added more examples, migration guide and fixed double url encoding bug