Currenly texts in docs may have too long lines like this:
its not pretty good for reading.
But if we will limit string to 7-10 words it will be more readable, see:
Just do #staticContent p { max-width: 40em; }
Nice advice =)
I mean just text. Not code examples or images.
Feature with limit words in string come from typography.
They have many adivce how we can make text more readble, but for me length of string seems more terrible.
1 Like
After my comment I did some research and found Readability: the Optimal Line Length - Articles - Baymard Institute which also confirms a line length of around 45 - 75 characters for readability.
Letās see if others comment.
1 Like
Letās just make our font bigger. (Ha Iām sure itās more involved then that)
I remember back in the day doin dynamic layouts that used some small view width value as the text size value. For the most part it would keep the same amount of text on screen at any given time no matter the browser size. (This was before mobile support considerations)
1 Like
All good for me! Feel free to send a PR
Sometimes we just have to add a line break into the markdown pages to make them more readable, itās easy to do even if you donāt know how Github works.
From your example:
- go to Documentation/How_to_use_MorphTargets.md at master Ā· BabylonJS/Documentation Ā· GitHub
- follow the docā link provided above
- replace:
Meshes can be deformed by using morph targets. A morph target must be built from a mesh with the **EXACT** same number of vertices as the original mesh.
Morph targets are used by the GPU to create the final geometry by applying the following formula:
- by:
Meshes can be deformed by using morph targets. A morph target must be built from a mesh with the **EXACT** same number of vertices as the original mesh.
Morph targets are used by the GPU to create the final geometry by applying the following formula:
I just have to press Enter here, and itās already more airy 
In this cas we can even use code tag ` and list, we get:
Meshes can be deformed by using morph targets. A morph target must be built from a mesh with the EXACT same number of vertices as the original mesh.
Morph targets are used by the GPU to create the final geometry by applying the following formula:
final mesh = original mesh + sum((morph targets - original mesh) * morph targets influences)
For instance, you can use morph targets to simulate the opening of a mouth:
- The initial mesh has a closed mouth. The morph target can be the same mesh but with an opened mouth.
- Then by changing the influence of the morph target (from 0 to 1) you can display either a closed or an opened mouth, or a mix of both.
Thats not too good. Imagine this on large screen like 2K+, event on the FullHD it will be strange.
My main work is creating websites, and I have some skill with it and with formatting text for pretty reading. We tried approach with relative font size and it was not good.
Yes, and for it purpose also may set larger line height.
Compare that, before:
and after:
I donāt think this issue should be solved by using linebreaks. This is a style issue that should be solved in css.
edit: I think I misunderstood vinc3r. What he is describing is adding paragraphs in markdown - not linebreaks.
1 Like
A little bit trickier than this since .scss and .pug are involved
Well, yes. If scss is used, then update the scss with your css.
Now I have remembered that āgrunt sassā compiles the scss files it is not as big a problem as I thought.
Just restricting the width of a paragraphs gives a couple of issues
multiple images on one line become one image per line, bullets points are not affected. More time needed and I have no more today.
Yep, not native english speaker here 
And I was talking about markdown tweaks just because itās easy to do by anyone. I was once tried to understood how the docā css can be modified, that was a failure ahah, because of this scss thing.
Yep, control-mousewheelā¦ I love it. I use it for forum-reading, too. Font-sizes for old people eyesā¦ yay!
For all readers, not just @Pryme8ā¦
Hey mobile device usersā¦ got mousewheel? Got control button? Got a useless piece of crap in your hands?
Whatever happens here, letās NOT start styling primarily for mobile devicesā¦ like the news services are leaning-towards, these days. Instead, demand that the mobile devices get control-mousewheel power.
Perhaps offer pick-a-style. Main thing, please donāt force mobile-device-stylingā¦ onto us desktop readers. Keep your walkie talkies out of our way. We desktoppers were here first, and for a MUCH longer time-span.
Aside: Iām test-driving that rant. Iāve never tried it beforeā¦ not many opportunities. Iām trying to create a war between the mobiles and the desktopsā¦ and create a personal internal conflict for those who use both. heh.
This IS a line-length issue and not a sentence-length issue, right? The topic is a little wobbly. (Notice my heavy-use of ellipsesā¦ for long sentence management.)
Are we ACTUALLY suffering from too much textā¦ due-to not enough āa picture tells a thousand wordsā diagrams? And/orā¦ lack of multi-lingual docs? And/orā¦ lack of multi-lingual playground-based tutorials? I dunno.
@Wingnut the mouse wheel is genius. Iām telling you modern browsers require modern solutions.
Hahaha
1 Like
heh. I think mobile devices need CONTROL buttons even more than wheels. AND alt, and meta, and shift buttonsā¦ because this opens their world to control-swipe, alt-pinch, shifted touch, ALL the gestures get more options/power.
Anyway, mobile hardware design is WAY off-topic, I suppose.
Iām pretty sure chrome does that. You hold alt or something and scroll the mouse wheel it should scale the text size.
Iāll look that up really quick.
Ok itās ctrl-mouse wheel or +-
Yeah, I use control-mousewheel ALL THE TIME, in FIrefox. Big fonts are happy fontsā¦ making miserably-complicated reading about shadow precisionā¦ happier.
Butā¦ no shift/alt/meta/control buttons on mobile devices (that I know-of)ā¦ so they donāt have a control-swipe to make THEIR fonts bigger ā¦ with/without text re-wrap.
Too bad we lost text coloring in the new forum postsā¦ cuzā¦ I like tooty-frooty colors, too (esp in docs-authoring). I live on Sesame Street. Rainbow-text is tough, thoughā¦ when allowing light and dark themes. Off-topic, sorry.
Sometimes Iām a little lazy, soā¦ 
Off-topic but about reading long texts on computer, notice the āread modeā icon (F9 key) on the left 
1 Like
Changes made as requested
2 Likes