improved package doc
rename example properties to match real ones