Add note to docs about deprecated options

Signed-off-by: Ben Firshman <ben@firshman.co.uk>