improved documentation for write_obs