daniel:// stenberg://Mar 2
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.
slpMar 3
Show threaddaniel:// stenberg://
and now I'm about to drop all uses of "just"... https://github.com/curl/curl/pull/20793
docs: stop using the word 'just' by bagder · Pull Request #20793 · curl/curl

It is almost never a good word and almost always a filler that should be avoided.

GitHub
Mar 3 at 7:40amWeb
Show threadMark JohnsonMar 3
@bagder I am forever rewriting my docs and commit messages to remove "just" and "simply".
Show thread Mar 3

@marxjohnson @bagder

> you just have to simply 'rm -rf /' to fix your issue

Show threadBlackoverflowMar 3
@mat3
really fast and easy! 
Show thread Mar 3
@blackoverflow one might say its just a simple but very helpful tip..
Show thread Mar 3
@blackoverflow one might say its just a simple but very helpful tip..
Show threadBlackoverflowMar 3
@mat3 obviously, anyone could to that much!
Show threadSimon 🐮Mar 3
@bagder You missed the opportunity to title the PR
"Just don't do it"
Show threadLars WirzeniusMar 3
@bagder I just can't think of a very good joke about this.
Show threadzhenechMar 3
@liw @bagder you need a justification for a joke? ;)
Show threadJohn William David ThomsonMar 3
@zhenech @liw @bagder every joke just needs a very good justification.
Show threadLars WirzeniusMar 3
@jwdt @zhenech @bagder I just want to say I am very much aware of what you just did.
Show threadzhenechMar 3
@liw @jwdt @bagder so, you have adjusted your expectations for another day on the internet?
Show threadJohn William David ThomsonMar 3
@zhenech @liw @bagder I've changed my style guide now because not ev... not all people j... simply accept my reasons for my word choices. I really hope if I mess this up that justice is served very swiftly.
Show threadAria <3 Mar 3
@bagder Why's Slopilot in the replies?
Show threadDaniel LundinMar 3
@bagder not just, though. just is nice 😆
https://just.systems
Just: A Command Runner

Show threadStewart RussellMar 4
@dln um … “with syntax inspired by make”? You might call that nice, but it sure isn't kind
Show threadjwzMar 3
@bagder So... maybe....
Show threadTimothy WolodzkoMar 3
@bagder what's the justification..?
Show threadLangerJanMar 3
@bagder
./curl$ grep "\bjust\b" -iIr . | wc -l
569
Show threaddaniel:// stenberg://Mar 3
@LangerJan yeah, it took some editing to get rid of those. It was not as easy as just deleting them all...
Show threadJan KatinsMar 3
@bagder judging by the first few pages of the diff: a worthy change!
Show threadRetMar 3

@bagder agree when it is used to imply that something is simple, quick or trivial (when it may not be to all people).

Disagree otherwise tbh, it’s basically a synonym for “only” in most other cases, which is pretty harmless? Maybe I’m not following.

Show threadJim GardnerMar 3
@ret @bagder I think that’s roughly what people mean. It doesn’t have many appropriate uses in documentation. Elsewhere, it’s fine. “I was just at the shops and x happened”…
Show threadSean BarrettMar 3
@ret @bagder Yeah, in code comments I also found a flag described as encoding whether we "just" did something, meaning it was true on the most recent iteration rather than previously, which is also a legit usage, but got to be rare in documentation.
Show thread⁂ Fish Id WardrobeMar 3
@bagder that seems … equitable
Show threadMat GaddMar 3
@bagder big fan of this move. In a similar vein, I try to avoid “obviously”.
Show threadMichael BoelenMar 3
@bagder
I say this choice is justified 😇
Show threadGothPandaMar 3
@bagder I still find myself using it frequently, but I'm training myself to rethink things when I hear myself use it. I've taken the position that using it usually means that I've made some assumptions, or oversimplified something, and I need to go back and look for them.
Show threadmrayMar 3
@bagder …just when I wanted to bring that one up. 🤗
Show threadBloognooMar 3

@bagder
I'd kill use of 'seems', 'got' and lowercase 'get' while you're at it. Probably 'have' and 'has' too.
Do I like my documentation very precise and unambiguous? Yes! Do I manage that? Not consistently.

I would appreciate a weasel word filter for vim so that I consider my written form with the precision and specificity that it deserves.

Oh! And 'like'. 'Like' can do one.

Show threadStewart RussellMar 4
@bloognoo what could possibly be wrong with "got"? It's only Americans who can't spell it.
Show threadBloognooMar 4
@scruss
I had it kicked into me in my English classes; I was get and got act a a shorthand that removes the information from the verb.
'get me a sandwich'... Is that
- pass me an extant sandwich we have here
-retrieve a sandwich from where the sandwiches come from
-buy me a sandwich
-steal a sandwich for me
- discover for me the thing called 'sandwich'
Etc
Show threadSean BarrettMar 3

@bagder "surely I don't... argh"

24 match: stb.h
4 match: stb_connected_components.h
1 match: stb_c_lexer.h
3 match: stb_divide.h
4 match: stb_ds.h
1 match: stb_dxt.h
1 match: stb_easy_font.h
1 match: stb_herringbone_wang_tile.h
2 match: stb_hexwave.h
20 match: stb_image.h
36 match: stb_image_resize2.h
1 match: stb_image_write.h
1 match: stb_rect_pack.h
2 match: stb_sprintf.h
4 match: stb_textedit.h
6 match: stb_tilemap_editor.h
8 match: stb_truetype.h
14 match: stb_voxel_render.h

& 56 "very"

Show threadStewart RussellMar 4
@bagder as someone who used to develop accessibility solutions by and with people with disabilities, thank you.
Show threadMelissa ​Mar 4
@bagder thanks for making my brain hyper aware of these words now 😭
Show threadfelipeMar 5
@bagder let’s do “simply” next? https://github.com/curl/curl/pull/20822
Show threadgloriouscowMar 6

@felipe @bagder

can i open a PR for 'quite'? :D

Show threadpallasMar 6
@gloriouscow @felipe @bagder You cannot simply just remove literally all filler words, like quite.
What will be left? Short precise documentation?
Show threadgloriouscowMar 6

@felipe @bagder

I've always wanted to contribute to such an important project.

https://github.com/curl/curl/pull/20841

Show threadMatthias AuswögerMar 6
@felipe @bagder There was a time when curl was much more simple.... 😂
Show threadHTeuMeuLeuMar 6
@felipe @bagder Chris Coyier (@chriscoyier) had a whole list back in the days: https://css-tricks.com/words-avoid-educational-writing/
Words To Avoid in Educational Writing | CSS-Tricks

I'm no English major, but as a writer and consumer of loads of educational (mostly tech) writing, I've come to notice a number of words and phrases that come

CSS-Tricks
Show threadWinni NeessenMar 6
@felipe
Show threadBilly O'NealMar 6
@felipe @bagder Exception: Simply lovely
Show threadMikeWasMar 6
@bagder This action is right and just.