updated spec and added readme example