`max_decommission_year` not marked as optional in the documentation

This is an optional parameter but there's no mention in the documentation that it's optional. We should mark it as such.

There may well be other related issues with other parameters - I haven't done a full check I just stumbled across this