Fix #1969 formatting, add information about multiline json

oops -- meant to add this to *release*