Rework metadata attributes extensions documentation.

Add a common use case to add entity categories - until now it's
hard for users to find SSP examples for how to do it.