added more docstrings. updated deal serializer with read-only shortcut attributes per nates request