fixed example 4
some type fixes
made attribute descriptions consistend with 'MUST return' langauge
Merge pull request #43 from tripzero/master

Fixes to attribute description language, example 4 and some type changes/fixes.