update docs about desc
description is optional on params too
update example