Parameters need bounds, and docs should be formatted to go onto subsequent lines to encourage full documentation and to make things fit onto the screen.