-
Notifications
You must be signed in to change notification settings - Fork 242
Justified Paragraphs with limited line length #1404
Comments
When the new haddock design was proposed, the number one complaint was that there was too much white space and people liked their long lines. The compromise reached was to have a max-width, but have it be large. I understand this is not to everyone's taste. However, the current large max-width is very much a conscious choice, and there's no pleasing everyone. I would vote to keep things the way they are, because previous experience suggests far more people would be unhappy than happy with any change such as that proposed. |
I was not aware that this is controversial. I had searched issues and pull requests for 'width' before opening this issue and read some discussion on the new haddock design. The author of the new design @NunoAlexandre wrote
I am under the impression that he did not account for larger monitors such as the one I have now and he never intended for lines to be that long. The screenshots he posted had short readable lines. In fact the motivation for the new design was
such that
is listed as a notable change. I don't think someone with a 1280px monitor undertook the effort of implementing a new design because he was bothered by hard to read long lines and a compromise was reached that limited the max-width to 1450px? Apparently the 'before' screenshot from @NunoAlexandre was not taken on his 1280px monitor because the resolution is 2560x1600. Rather it seems to be from some high dpi display because the font is many more pixels large. This is a good example why the paragraph width should be specified in
I read the relevant pull requests (#721, #782, #949) and I did not see anyone complaining about too much whitespace or arguing for long lines. The closest I could find was this
But this issue is not about mobile displays and 3 runs of the roman alphabet seems fine If I have overlooked any complaints, can you link them? I wasn't able to find them. I think there is a difference between being bothered by empty space and finding something hard to read. Nonetheless I agree that we should strive to utilize empty space. For example I'd like to have a table of links to modules from the same package below the table of contents. |
I find that Haddock produces way too long lines that are not easy to read. The fix for #405 still produces too long lines in my opinion.
Screenshots
Screenshots
Screenshots
Also for the screenshots I removed the 0.2em top and bottom padding of the cells in the instances table and I personally prefer it .
Screenshots
Traversable
. Inbase-4.12.0.0
the layout of the instances list did not take as much vertical space.The text was updated successfully, but these errors were encountered: