Reminds me of a comment I once came across in a work application’s code: “This function took forever to write correctly. It was hard work. I didn’t document it. Figure it out.”
Of course the variables were not defined properly and were named esoterically.
the variables were not defined properly and were named esoterically
I wonder why it was so hard and took so long to write
Poor skill, mostly.
As demonstrated by the variable naming and documentation.
Oof!
deleted by creator
At what point is documenting decompiled code easier?
Me: “haha…no” proceeds to delete function “whoever wrote this can figure it out again.”
$ mysterytool $WHAT DID YOU DO?!
$ mysterytool -vv DEBUG: Complete. $Knowing my luck, It probably deleted a rarely used system library and will lead to unpredictable crashes.
I don’t understand how devs can be too lazy to write documentation but somehow they’d rather explain the same shit in discord over and over and over and over and over and over
The help command is one of the first things I work on in any project. Even if I’m never gonna share it, my future self will appreciate it.
Even on simple scripts, it’s so help to remind yourself however the hell you made it work.
I always document a lot because I forget what I was doing one week after.
Why is discord so popular in non-gaming circles? People use it as a shitty, bloated and centralized IRC clone, with the voice fuction being completely ignored.
I’m no discord fan but my recent attempts with using IRC failed because I had incorrect reverse dns or some shit like that. Obviously I have no control over that in a consumer connection.
There are still better alternatives than Discord, though :)
Easy: people who still use Discord have brain rot
Why?
i write poorly documented code on my solo projects because i am lonely
I write buggy software so that users will email me.
I think it’s loneliness, honestly.
That and corporate work environment tends to rewards those that can explain stuff vocally ad nauseum.
As someone who writes fairly extensive documentation, I can assure you that it doesn’t matter. People will still ask questions in your Discord that are answered in your documentation.
I’ve learned that you kind of have to strike a balance between being terse enough that people will read it and verbose enough that it’s actually helpful, but there is a minimum number of questions you will always get.
At work, I am one of the few who actually documents. Not only with Doxygen, but I also write real documents regarding all kinds of topics.
Guess what? “I know you have this documented somewhere, but could you just quickly explain again how this common task works?”
I was recently trying trying to get help on a clipboard program someone had recommended me, clipq. What I found instead was a GitHub discussion where the dev said “I’m not sure what you mean by ‘man’ pages” in response to someone asking for them. I think I need to find an alternative
Did they at least provide woman pages then?
/s
I’ve only known about (and always use) xclip.
Be the change you want to see in the world and create a PR. 😃
Soy devs have invaded Linux.
What do you mean by this?
“You’re not a real dev if don’t know [insert thing here]”
I’m not seeing the soy connection
It’s a derivative of https://en.wikipedia.org/wiki/Soy_boy
Haha, I made this :) Here’s the blog post I created it for, if you want a bit of context:
Correct, I shamelessly stole it!
Also, sorry, I stole it.
No worries :)
But also
mysterytool --help
mysterytool: unrecognized option: '-'ok then…
mysterytool -h
mysterytool: unrecognized option: 'h'mysterytool --help ‘--help’ unrecognized option, -h for helpI will burn this motherfucker to the ground
Or the opposite:
mysterytool -h -h unrecognized option, --help for helpBoth need to burn.
Sometimes
mysterytool -Hworksmysterytool -haaaaaalpSome of the older programs and scripts I’ve seen in the codebases I help maintain have
-uor-?. If I have an excuse to do any changes to them I’ll usually change them to use-hand--help.
And
mysterytool -hmysterytool: try our info page that requires a custom viewer because gnu is better than standards. And there is no regular man page because fuck youIf I can’t get it with
tldr mysterytoolafter all that, then clearly the developer intended it to stay a mystery.strings mysterytoolAs a last resort haha
It could be worse. The documentation could be online, only accessible through a paywall.
Okay, Oracle.
Oh, they do it, too?
If the program’s author hasn’t bothered to properly document its function, then it has no business being on my machine.
“tHe PrOgRaM iS sElF dOcUmEnTiNg”
That claim doesn’t even work for the 0 line shell script that used to be /bin/true (which is why it is no longer a 0 line shell script), much less any more complicated program.
Fuck those people, people who says that usually doesn’t even understand half the time. When I ask people like that when they write a functionality a certain way during code review usually they’ll just quote someone on Twitter or some blogspam article saying A is shit, B is the best way to do things.
you forget StackOverflow. I saw my coworker once copy-and-paste code… from the question… and not understand why it wasn’t working… I’m all for using StackOverflow to get help with weird problems but, most of the time, simply reading the docs and applying that knowledge to the problem you are trying to solve is enough. a forgotten art for sure…
I’d pretend to be Joey from Hackers and just throw commands at it to see what happens. Maybe I’ll make an ATM in bumfuck, Egypt spit out hundreds of dollars or find a worm in a garbage file 🤷🏻♂️
Hack the planet!
It’s like people don’t like surprises anymore.
Embedded *nix be like
Cries in busybox
That, at least, had an excuse to be terse. If you use busybox, you probably have a real machine with the ability to browse the online documentation, anyway.
Legacy *nix vendor tools be like
Exclusively installed through some dodgy PPA you got from a blog.
strings `which mysterytool` | lessGive up your darn secrets before I start fumbling around with
straceand get even more frustrated!I just want to say this is a masterful use of the format.
I’d try
mysterytool -H-H for Hard drive to delete, -h is help
-H is for Hforce
-his halt.Which assumes you also wanted to catch fire because you didn’t set
--halt-without-catching-fireDo developers get hard-ons for using nonstandard flags?
Use
-h, --help. None of this “no hyphen” bullshit or using the plus sign or a different flag like--infosudo shutdown -h nowIt makes sense in context. Whaddya gonna do?
-His for “hell no just uninstall”Look, if they can’t stick to established convention and they’re not gnu (and thus magically excusably arrogant as fuck because #stallman), then you just know they’ll be somehow dragging in remote libraries or something equally as fuckwitted; so just remove it and live your life.
find / -name mysterytool -exec rm {} \;rm $(which mysterytool)?What if that returns just an alias?
But really the best way would be first to try one’s distro manager to uninstall/purge the package. Unless it was just manually installed by the user.
Oh, maybe that’s it! It only exists in
~/bin, and OP is having a psychotic break, is just now finding out about their split personality!
Use
+;\;is for peasants.Y u no
-delete
