added comments to some public methods
modified example to put logic into soap object