Update custom shape docs.

Supersedes #692 now that we ship CaseClassShape directly in Slick. Review by @cvogt 
Custom case classes doesn't mean anything useful by itself.