daniel:// stenberg://Mar 11

The "badwords" script we use in curl CI to detect words in documentation and source code that we want to avoid took 48 seconds to run just a few days ago.

Then it took 8 seconds after an optimization take by me.

Then 3.6 once the regexes were improved by @icing

Then 1.1 seconds with more tweaks on the regex use.

Now @vsz works at taking it yet a little further...

Show threadmanchickenMar 11
@bagder @icing @vsz Sounds like a fun script. Does it say any _naughty words_?
Show threaddaniel:// stenberg://
@manchicken @icing @vsz it's more boring than so. This is what the config file looks like: https://github.com/curl/curl/blob/master/scripts/badwords.txt
Mar 11 at 11:08amWeb
Show threadmanchickenMar 11

@bagder @icing @vsz Aww, you're right, that _is_ boring.

About 20 years ago I wrote a swear filter for ZoomShare.com which replaced every English swear word with some form of the word "watermelon." This was based on a middle school teacher who used to make fun of me for swearing in class.

"What in the watermelon are you talking about?" "That's watermeloning stupid." "What in the watermelon?!" That sort of thing.

Swear filters are equal parts fun and futility.

Show threadAdvanced Persistent TeapotMar 11
@manchicken @bagder @icing @vsz sounds fun. Do you live in Swatermelonhorpe?
Show threadmanchickenMar 11
@http_error_418 @bagder @icing @vsz no, but if you can hum a few bars I’ll join right in!
Show threadThomas Fach-PedersenMar 11
@bagder @manchicken @icing @vsz Good call on banning “simply” and “just”, those have caused me many headaches over the years.
Show threadmanchickenMar 11
@madmoose @bagder @icing @vsz 👏
Show threaddaniel:// stenberg://Mar 11
@madmoose @manchicken @icing @vsz all of these are done in an attempt to make us write better, consistent documentation
Show threadmanchickenMar 11

@bagder @madmoose @icing @vsz friend, I'm not saying that it's not good or important work. I was just wondering "there's no way Daniel doesn't have a better story about the most foul-mouthed submission to documentation of all of us," and I want to hear that story.

Your commitment to constructive documentation is already something I celebrate every time I have to remind myself which flags I need to use. `man curl` is such a common command for my box I'm pretty sure it cannot be deleted from `.zsh_history` no matter how hard I try. It's like an over-used record, I've worn a groove in the text file.

Show threadthedoctorMar 11

@madmoose Maybe a silly question but how are these bad? Are they considered too colloquial or bad style?

Also, I noticed that "however" is considered bad. My writing must be quite terrible, I can't cope without that one!

@bagder @manchicken @icing @vsz

Show threaddaniel:// stenberg://Mar 11
@thedoctor @madmoose @manchicken @icing @vsz they help us write better and more consistent documentation that follow the style we want
Show threadmanchickenMar 11
@bagder @thedoctor @madmoose @icing @vsz It's always nice to have a style guide that can help find mistakes prior to PR. It's never fun to burn time in PR comments quibbling over wording and tone.