Expand documentation for fill_values

fixes #2080
[skip ci]

cc: @taldcroft 
Since I copied this verbatim, I skip the CI.
Superceeds #2080 , see there fore more discussion.