Update custom shape docs.

Supersedes #692 now that we ship CaseClassShape directly in Slick. Review by @cvogt 
"Custom *case classes* are frequently used as monomorphic record types" refers to the general concept, independent of the lifted embedding. I'll change the net bit to make that clearer.