Line breaks inside tables break formatting

[jonty-comp]

In our docblocks we use line breaks to keep to 100 column width, but unfortunately it seems this breaks table rendering in Github flavour: example

Some documentation I see suggests using HTML inside the table, but I'd rather just strip line breaks personally. It's up to you guys how you would like to handle it!