slp
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.
I can tell you that this bites me just about every time I write more than two sentences. Then I go back, edit and push a fixup commit and hope that I learned something. Again.
Richard "mtfnpy" Harman (he/him)@bagder *shock collar fires* You used the word "just".
Ludwig Vielfrass@bagder Very good. π
Derick Rethans@bagder I also block "just" this way, and "easy"
@derickr I'm actually currently in process of doing the same for "just"!
Wouter de Jong@bagder @derickr you might be interested in a tool like https://vale.sh (or a more minimal, but js based, https://alexjs.com).
Vale has many rulesets to improve the writing style/make all docs consistent.
Vale has many rulesets to improve the writing style/make all docs consistent.
Sharlatan@sharlatan @bagder I have a list in my .vimrc:
highlight badWords ctermbg=red ctermfg=white
fun! HiBadWords()
match badWords /\c\<\(obviously\|basically\|simply\|of\scourse\|clearly\|just\|everyone\sknows\|however\|so,\|easy\|PHP\sUnit\)\>/
endfun
autocmd InsertEnter *.txt call HiBadWords()
autocmd InsertLeave *.txt call HiBadWords()
Fritz Adalis
John Harris
Richard "RichiH" Hartmann@bagder that's very often
John Gruber@bagder What if you wanted to document your rule against using the word?
@gruber the rule is generic: we have a list of banned words and expressions. We don't need to specifically mention the words in that list! π
derdilla
οΏ½
fraggle@bagder @gruber
Full list is here in case anyone else is curious like I was:
https://github.com/curl/curl/blob/master/.github/scripts/badwords.txt#L84
Full list is here in case anyone else is curious like I was:
https://github.com/curl/curl/blob/master/.github/scripts/badwords.txt#L84
Kaito
Bryan Steele 
β
Gentleman Programmer
Shane Celis@bagder Vary very good.
Moritz Dietz@bagder curl transfers are much secure
ROTOPE~1 βοΈ@moritzdietz @bagder bigly secure. The hugest security.
πΊπ¦ Johnydon 
he/him
Jeff Geerling@bagder I'm very glad you have such high standards!
Ozzelot 
echopapa
iloo
gloriouscow@bagder of course i had to be a smartass and look
Darth Hideout π³οΈβπ@bagder Truth Social ought to have a similar automated check, at least for a particular account.
Pink
Adam
hackbyte #antifa #friendica 13HB1LOL i didn't know that ..... but yeah, it makes sense.. in it's own way. ;)
Monospace Mentor@bagder I use Vale to lint my prose. It calls "very" out as one of a set of "weasel words".
my English teacher banned the use of the word "just" in most contexts
"I was just xyz..." for instance
redundant
@bagder
"I was just xyz..." for instance
redundant
@bagder
Wolf480pl
Joris Meys@bagder
s/very/way
s/very/way
Zachary Cutlip@bagder βSubstitute βdamnβ every time youβre inclined to write βveryβ; your editor will delete it and the writing will be just as it should be.β
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.
Mitex Leo@bagder very good
Jared White (ResistanceNet β)@bagder we did a similar sort of cleanup (not a CI check tho) in @bridgetown a while back removing the word "just". Nobody can "just" run this command or "just" install that plugin any more. π
Kraftwerk-Das Model Collapse
SnowBlind2005
Dror Bedrack@bagder yes, I remember that meme from a few years ago. It's the kind of stuff techbros would do to feel superior. Do you also try to say "thank you" instead of "sorry"?