Fusion internal formatting about fusion

[Anaminus]

For almost all points, there are going to be no strong reasons to pick one way over the other, and trying to enforce a custom format manually is a exercise in futility. I would recommend finding a formatter (StyLua seems good), pick the configuration that you like, and just roll with that. Any variability allowed by the the formatter is fair game.

[autonordev]

I would use the Roblox styleguide - it just saves time having this discussion.

Styleguides tend to be more arbitrary than practical. However special consideration should be given for how the diffs and readers are affected.

[dphfox]

This is definitely stuff we need to sort out, so thanks for raising the issue!

Quick comment on:

Empty blocks or single statement blocks being multi-line

I try not to place multiple things on the same line for diffing purposes - imagine we have the following code:

if x < 0 then return end

If we had to add some code to run inside that special case, it wouldn't diff as nicely:

- if x < 0 then return end
+ if x < 0 then
+     doSomething(x)
+     return
+ end

Versus the current standard, which diffs better:

if x < 0 then
    return
end

  if x < 0 then
+     doSomething(x)
      return
  end

By the way, anyone else who has issues with formatting, please drop them in here - we need to review this before we write too much code 🙂

[Dionysusnu]

I would use the Roblox styleguide - it just saves time having this discussion.

Styleguides tend to be more arbitrary than practical. However special consideration should be given for how the diffs and readers are affected.

The Roblox styleguide is quite outdated, and does not cover a range of topics, most notably Luau types.

Can highly recommend StyLua. It does however automatically create parentheses for constructors like New("Frame" )({}) .

This is an ongoing issue in StyLua. JohnnyMorganz/StyLua#242

[dphfox]

For reference, the current style guide (needs updating): https://github.com/Elttob/Fusion/blob/main/style-guide.md

[Dionysusnu]

I try not to place multiple things on the same line for diffing purposes - imagine we have the following code:

if x < 0 then return end

If we had to add some code to run inside that special case, it wouldn't diff as nicely:

- if x < 0 then return end
+ if x < 0 then
+     doSomething(x)
+     return
+ end

I don't see this bigger diff as a big issue, because the affected lines are still correct. The reason for trailing commas and final newlines are that the diffs would affect unrelated lines. That's not the case here, so I don't think the same reasoning should apply.

[dphfox]

I think it'll be worth waiting to see what other people think then - I remain unconvinced, but I'm open to changing my mind if other people also think differently.

[CaptinLetus]

If we strictly use the Roblox Lua guidelines, multiple statements should be on multiple lines https://roblox.github.io/lua-style-guide/#general-punctuation

[noah-peeters]

Can highly recommend StyLua. It does however automatically create parentheses for constructors like New("Frame" )({}) .

[dphfox]

Deferring to v0.3