updating README with spec and verbose description