It seems like the far more common case is a single line comment flavor though.  I worry a little that this example could be confusing since the array in `blockComment` means something different.

How about we show one example of the common case where you're just passing a single line comment syntax in, and then add another section further down covering the more "advanced" use case of multiple different syntaxes?