I tried to improve the layout of an example table in one story by adding newlines before each comment line (to improve the legibility a bit),
however it turns out that an empty line in the table gives a list of empty parameters in the examples (e.g. ||| when you have 2 parameters).
I think it would be better if empty lines are ignored, unless I'm missing something.
If that is ok, I can write a patch.