Update fill_values docs

The change in the default setting for fill_values required some more extensive documentation updates which are provided by this pull request.

@stampsrule - you should just merge this into your issue-919-work branch and it should show up in the main pull request.