Update custom shape docs.

Supersedes #692 now that we ship CaseClassShape directly in Slick. Review by @cvogt 
Would be great to also add that this can be used as an alternative to `<>` requiring the shape definition, but allowing access the members unlike MappedProjection.