replace long dashes
make the params bold to more closely match the yard output
describe the use of nil as a default value
expand the array docs