Corrected method documentation and what it really throws

(belongs to issue #33)
Removed accidentally set non-null annotations
Removed transient flag from field 'category' because we do not set it
during deserialization