adding documentation details for code completion
properly encoding fields