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

ktlint_code_style

?

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.

Most innovations are to be expected in the ktlint_official code style

That's really unfortunate 😕

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.

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/

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.

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.