ammend scheduling_parameters, supersedes #519

small fixes to #519 to create more consistent documentation style and ensure Jekyll compiles.