Add documentation on modelling the catalogue

This includes two examples for product attributes.

Also fixes two "document not referenced" warnings.

Fixes #794.