[docs] clarification in fidl doc

Primarily clarified "one blank line (two consecutive newline characters)" rather
than "one newline" (which is doesn't create a blank line). There are other
formatting changes for consistency as well.

Test: none
Change-Id: I31aa64b762daf2b10d07580fea3589f5c32e1ba6