added entity description

[ggstuart]

Entity objects can have a description (as shown in example 4) so I have added this to the specification.