fix readme examples & add requirements sections