Moreover using github style for describing a required parameter also may increase readability.