updating documentation re. assets/representations