minor changes to spec
end of chapter 3 tutorial commit