small spec changes

I started writing specs.

I am not sure how you prefer me to send patches. Do you think we should use something like reviewboard?