Also, is there documentation somewhere about what ...

# ktlint

[Jonathan Lennox]

Also, is there documentation somewhere about what the substantive differences are between the various values of ktlint_code_style?

[Paul Dingemans]

The name of the rule is not entirely accurate. There is no documentation with substantive differences. It is hard to maintain. Most innovations are to be expected in the ktlint_official code style. The other code styles are more intended for users that adapted ktlint in the past and do not (yet) want to migrate to the new code style.

[eygraber]

Most innovations are to be expected in the ktlint_official code style

That's really unfortunate 😕

[Paul Dingemans]

It depends. New rules that are exposed by default in the ktlint_official code style can still be enabled in the other code styles as well. Whenever a new rule is applicable in all code styles, it will just be exposed as a normal rule. Same for bugfixes.

Formatting which does not comply with IntelliJ IDEA default formatter, will be exposed in ktlint_official only. This is used in case the other code styles follow inferior IntelliJ IDEA formatting due to bugs in the formatter. Or, when from a consistency viewpoint, a different format is preferred.

Also, the ktlint_official code style contains formatting rules that go beyond what is defined in the Kotlin coding conventions and Androids Kotlin styleguide.

The old code styles will not be removed, nor deprecated in the foreseeable future.

[eygraber]

Also, the ktlint_official code style contains formatting rules that go beyond what is defined in the Kotlin coding conventions and Androids Kotlin styleguide

😅 https://xkcd.com/927/

[eygraber]

inferior Intellij IDEA formatting

I find it a little hypocritical that you're using that kind of language after insisting that users don't criticize your decisions in ktlint.

There are some bugs in the Intellij formatter, but nothing crazy. I know it's difficult for you because you support the proper spec when they don't, but I think they've publicly said that they're not working on it so much due to a lack of resources.

[Paul Dingemans]

Ok, you read inferior differently than I meant. IntelliJ IDEA formatting is very good although it has way to many exceptions which result in inconsistent formatting. What I really meant was that there are multiple bugs in IntelliJ IDEA formatting which are still not solved are being open for several years. What is most disturbing, that there is almost no response on those bugs.

[eygraber]

I understood, but was making a point that you could afford the same leniency to those who use similar language in the ktlint repo 😅

I personally think that because of the inconsistency a certain level of customization is warranted that goes beyond the code styles. I happen to like the level of customization that detekt offers with their rules; it allows a lot of these rough edges to be smoothed out in a way that works per project, and doesn't feel like it's bikeshedded.