daniel:// stenberg://a detail you probably didn't know: nowhere in any #curl documentation do we use the word "very". It is a banned word enforced by a CI check. This rule encourages us to rewrite and instead use more appropriate words. Makes us write better English.
Andrey Bondarenko@bagder for a non-native speaker, what exactly is not good with the word 'very'?
@shaman007 it is too simple. There is almost always a better way to phrase the same thing without it. very happy = excited, very glad = thrilled, very hungry = starving, etc. So the use of "very" is a sign that it can be said better.
@bagder l need to wrap my head around this, never thought about it before.
@shaman007 it takes a little getting used to I admit, but I find that it helps me write better
@bagder thank you, mmm... a lot. No, appreciate for your answer!
Lindsey Kuper@bagder @shaman007 I would add to that point by saying that in technical writing, it's usually better to use adjectives to add information, rather than just adding emphasis. For me, the only information that "very" adds to a phrase like "WizWoz is very fast" is "Wow, it sure sounds like they really want me to believe that WizWoz is fast."
I'm going to be more skeptical than if the "very" hadn't been there! If WizWoz really were fast, they wouldn't need to throw in adjectives to persuade me.
@lindsey @shaman007 indeed a good point!
�@bagder @shaman007 so no very excited :p
BITNACHT@bagder @shaman007 IMHO for technical documentation: simple is better. BTW. Some spellcheckers can help you write better style before even saving the text.
@bitnacht @shaman007 in a distributed world where everyone uses their own tools and editors we need the checks in CI anyway. Those are the rules that bind us all.
@bagder @shaman007 I just don‘t think this example will either increase your productivity nor help the people reading the paragraphs in question. But if it makes you happy: keep up the enthusiasm.
@bitnacht @shaman007 Writing coherent and good documentation is a huge task. Avoiding a single word is just a tiny little bit of that and will of course in itself not make much of a difference. But I am convinced using coherent, proper and easily read language helps users. So we try to do that.
@bagder @shaman007 100% agree. And it is true that if you are forced to go over a text for a second time, you are likely to find ways to make it clearer and more concise along the way. So I see your point now.