fixed descriptions: match required/optional params