Spec review PRs

I’ll try to look at the PRs today and I’d be down for a call this week or next.

Had some other thoughts that might be worth discussion: