added a more encompassing spec and used it as a readme example