HV-878 Integrating Optional and JavaFX types

> why does that matter? Smaller diffs?

Exactly. A fixed limit potentially causes a whole paragraph to be re-wrapped when changing just the first line so it exceeds the limit. You just added one one word and the whole paragraph may appear to be changed. This is avoided by the alternative approach, making changes much easier to follow. Note that this no theoretical thing, changes are much easier to grasp since we stick to this style.

> One of the promises of asciidoc is to make writing much more like ordinary prose.

Hum, in which way does that help with diffs? If you work with fixed line lengths, this problem is there no matter which document format you use.

> The line breaking you guys are suggesting is ill defined

Ill-defined in which way? The rules are clear and as said, you get used to it very quickly. Also there is no need to fight about specific breaks and whether they are right or not, just do it the feel you think it's good. We had no single situation in OGM where this would have been a problem. I suggest you give it a try yourself, you'll see that it works.

> and if anything reserved for poetry.

How does it relate to poetry? It works perfectly for our technical docs.

Hardy, I understand you're skeptical, but again, I suggest try it out yourself and I'm quite sure you'll see that the benefits out-weigh the initial unfamiliar feeling.