Document expected behaviour related to default values

[Olivier Mélois]

See #1405 for some context.

We ought to make it somewhat clearer in the documentation.

We also ought to add to the 0.18.0 changelog entry that the behaviour changed at that point.