why does ktfmt change the formatting of this kdoc:...

# ktfmt

[christophsturm]

why does ktfmt change the formatting of this kdoc:

/**
- * Lifecycle functions for resources that are used by tests.
- * This is a separate interface because it is available in the ContextDSL and in the TestDSL
+ * Lifecycle functions for resources that are used by tests. This is a separate interface because it
+ * is available in the ContextDSL and in the TestDSL
  */

I think the first version is more readable because each sentence has its own line.

[Colton Idle]

I think ktfmt uses tor norbyes kdoc formatter https://github.com/tnorbye/kdoc-formatter

[Colton Idle]

i suppose you can ask the question right there in its issue tracker

[Colton Idle]

by the looks of it. it does format it the way i would assume it should be formatted IMO.

[christophsturm]

thanks! maybe you are right that its better that way. I just thought that if it takes 2 lines anyway the two sentences could be on separate lines.

[Colton Idle]

Maybe if you put an extra blank line in between them then it wouldn't reformat?

[christophsturm]

btw it seems ktfmt really uses kdoc-formatter but by copying the source code instead of as a dependency.

[christophsturm]

and you are right, adding an extra blank line will stop the reformatting.

[Colton Idle]

ooh. interesting!