Document custom representation types

[adamgundry]

It should really be clearer how to use custom representation types (i.e. they should be covered in the tutorial documentation). Moreover, such types should probably be marked in the generated schema documentation.