[ESLint] Why are padded blocks not permitted?

[banhathome]

I don't quite understand why the ESLint config file prohibits padded blocks. What would happen if you needed to make a comment after a block opens:

// ESLint Error: "Block must not be padded by blank lines. (padded-blocks)"
$document.ready(() => {

  // Initialize/Render React
  React.render(React.createElement(Index), $react.get(0));
  ...
}

// Violates 17.2 of the style guide: "Put an empty line before the [single-line] comment."
$document.ready(() => {
  // Initialize/Render React
  React.render(React.createElement(Index), $react.get(0));
  ...
}

In addition, I don't see anywhere in the style guide where padded blocks are prohibited.

[justjake]

Yeah, the eslint config is out of sync with our actual styleguide in a number of places. I am working on a test suite to bring them together here:

#480

[justjake]

However in this case I think we should amend the styleguide to say that a comment on the first line of a block does not need a preceding line.

[banhathome]

I don't see anywhere in the style guide that mentions padded blocks, so maybe we should make a change in the styleguide to address it as well.

[banhathome]

#547, which was recently merged, addresses this issue by adding a section to the style guide that prohibits padded blocks.

[jbcpollak]

I know this question is closed, but I am wondering if there is a justification for why padded blocks aren't allowed? I noticed both AirBnB and Google's styles disallow it, so we are following the same convention, but we are wondering why.

[ljharb]

Whitespace is beneficial when it adds readability, but not when it creates visual noise. With syntax highlighting, lines padding blocks add zero benefit, but increase the vertical length of code, and reduce the amount you can see at once.

[jbcpollak]

@ljharb - good enough for me, thanks! Would be awesome to see that in the style guide (I often wish style guides had more justifications) but that is very helpful.