Just a observation on the Primer content:
In section 2.2 you discuss the use attribute declaration for making
attributes required, but it looks as though it's not used in any code
examples that you have (although there are a couple with fixed). I think
required is probably going to be used quite often, so an example using it
would be nice.