Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Search - "docs sucks"
-
I'm drunk and I'll probably regret this, but here's a drunken rank of things I've learned as an engineer for the past 10 years.
The best way I've advanced my career is by changing companies.
Technology stacks don't really matter because there are like 15 basic patterns of software engineering in my field that apply. I work in data so it's not going to be the same as webdev or embedded. But all fields have about 10-20 core principles and the tech stack is just trying to make those things easier, so don't fret overit.
There's a reason why people recommend job hunting. If I'm unsatisfied at a job, it's probably time to move on.
I've made some good, lifelong friends at companies I've worked with. I don't need to make that a requirement of every place I work. I've been perfectly happy working at places where I didn't form friendships with my coworkers and I've been unhappy at places where I made some great friends.
I've learned to be honest with my manager. Not too honest, but honest enough where I can be authentic at work. What's the worse that can happen? He fire me? I'll just pick up a new job in 2 weeks.
If I'm awaken at 2am from being on-call for more than once per quarter, then something is seriously wrong and I will either fix it or quit.
pour another glass
Qualities of a good manager share a lot of qualities of a good engineer.
When I first started, I was enamored with technology and programming and computer science. I'm over it.
Good code is code that can be understood by a junior engineer. Great code can be understood by a first year CS freshman. The best code is no code at all.
The most underrated skill to learn as an engineer is how to document. Fuck, someone please teach me how to write good documentation. Seriously, if there's any recommendations, I'd seriously pay for a course (like probably a lot of money, maybe 1k for a course if it guaranteed that I could write good docs.)
Related to above, writing good proposals for changes is a great skill.
Almost every holy war out there (vim vs emacs, mac vs linux, whatever) doesn't matter... except one. See below.
The older I get, the more I appreciate dynamic languages. Fuck, I said it. Fight me.
If I ever find myself thinking I'm the smartest person in the room, it's time to leave.
I don't know why full stack webdevs are paid so poorly. No really, they should be paid like half a mil a year just base salary. Fuck they have to understand both front end AND back end AND how different browsers work AND networking AND databases AND caching AND differences between web and mobile AND omg what the fuck there's another framework out there that companies want to use? Seriously, why are webdevs paid so little.
We should hire more interns, they're awesome. Those energetic little fucks with their ideas. Even better when they can question or criticize something. I love interns.
sip
Don't meet your heroes. I paid 5k to take a course by one of my heroes. He's a brilliant man, but at the end of it I realized that he's making it up as he goes along like the rest of us.
Tech stack matters. OK I just said tech stack doesn't matter, but hear me out. If you hear Python dev vs C++ dev, you think very different things, right? That's because certain tools are really good at certain jobs. If you're not sure what you want to do, just do Java. It's a shitty programming language that's good at almost everything.
The greatest programming language ever is lisp. I should learn lisp.
For beginners, the most lucrative programming language to learn is SQL. Fuck all other languages. If you know SQL and nothing else, you can make bank. Payroll specialtist? Maybe 50k. Payroll specialist who knows SQL? 90k. Average joe with organizational skills at big corp? $40k. Average joe with organization skills AND sql? Call yourself a PM and earn $150k.
Tests are important but TDD is a damn cult.
Cushy government jobs are not what they are cracked up to be, at least for early to mid-career engineers. Sure, $120k + bennies + pension sound great, but you'll be selling your soul to work on esoteric proprietary technology. Much respect to government workers but seriously there's a reason why the median age for engineers at those places is 50+. Advice does not apply to government contractors.
Third party recruiters are leeches. However, if you find a good one, seriously develop a good relationship with them. They can help bootstrap your career. How do you know if you have a good one? If they've been a third party recruiter for more than 3 years, they're probably bad. The good ones typically become recruiters are large companies.
Options are worthless or can make you a millionaire. They're probably worthless unless the headcount of engineering is more than 100. Then maybe they are worth something within this decade.
Work from home is the tits. But lack of whiteboarding sucks.37 -
Android docs suck so hard 😇
Google sucks so hard at making APIs 😄
Wraps everything in libraries, whose only purpose is to hide their incompetence 😛13 -
Shit guys, I cannot even begin to tell you about how tired I am at seeing gifs at every single.fucking frontend article. I cannot enter a single Medium/Dev.to without it being plastered in the most random fucking gifs you have ever seen.
Its bad enough that your average Medium/Dev.to is as shallow as the little puddle you spill on the floor after watering your cactus. With the added gifs, it just sucks so bad. I mean, who's fucking idea was it to plaster reading material with distracting content anyway? I wanna hunt them down and shove something right up their arses.
Back in uni when I started dabbing into frontend, my feeble brain thought it was quite refreshing after peering over java docs every day. Nowadays though, I cannot even manage to read these mostly shitty arse articles without wishing I was dead.
Also, I wonder if this is also the case for the java, .net, python, rust community?15 -
Got an idea that needed prototyping, remembered that people always said Bootstrap is a good UI framework for quick prototyping. Had a doubt though, as the last time I checked Bootstrap sucks.
I ended up wasting hours to make it work with webpack. Turned out it still sucks.
The most irritating thing was they tell people to install the latest beta, or even alpha version on their website, not the stable one. Who the fuck would do that?
When you do the bare `npm install bootstrap`, it will install the latest stable version, but the docs page defaults to the... guess what, the latest beta version. I wasted nearly an hour just to figure out why the styles weren't working like the examples in the docs.3 -
wow... the regular react community sucks...
where with react-native 3rd party libraries/components have very clear and detailed docs, the normal react libs out there are like:
20K starred component
"here is a .txt file with some props, TS? yea we use it, but everything is just set to ?: any"
quite the shame :/3 -
Angular is not fun to work with. The amount of jumping between files to do a thing is tiring. And its documentation fucking sucks.
I guess I'm just used to single file components and Laravel's amazing docs...5 -
Love writing comments, hate writing documentation.
Ugh, I know it is needed but just don't care about it as much as the code/comments which is a more direct 'here is what this does' approach. Writing idiot proof documentation sucks. Any little change? Have to remember to update the docs. Yeah, not happy.1 -
I found a budget salary for dev with 4-5 YOE in 2011 in my company, digging through internal old docs.
Assuming 2% increase per year, the 2023 budget salary is now EUR 15k more than what average dev get in my company.
I remember that someone mentioned similar thing in other socmed where he found through internal docs, salary for his position 10 years ago and now are the same, totally neglecting inflation.
On the other hand house/property values has doubled within 10 years.
How can we pressure companies to give us appropriate salary?
When I ask for increase, they will just say no because it's the market rate, but the market rate sucks.5 -
Google documentation sucks!
Lack of practical examples. They show us very simple example like clicking on button and then straight away redirect to API docs.
Wait, let me at least understand how things fit in together.
Me: Hey google where is step by step guide, at least for setup?
Google: We don't do that here!5 -
I can't read a documentation 'til the end. I, on the first few parts, would be like: "Oh this documentation is so good. Why would someone need a tutorial for this?" And then suddenly: "What the fck is this sht? I don't understand life anymore." So I end up buying a course on Udemy cause all the other YouTube tutorials are rubbish.
-
Hey documentation providers! Some of us don't want to have to go to slow ass websites to look up everything about your code, system, library, api, etc. It also really sucks when trying to work on those systems without an internet connection. So, please provide offline documentation.
A special thank you to Python for providing help files with Python itself. This has been a life saver when working offline.
Also a special fuck you to Bethesda for not providing an offline version of the Creation Kit wiki. Everything else you do is nice, but please provide offline docs.11 -
Why the fuck is gradle so horrible.
I literally have no idea why anyone would ever use this thing (other than being forced too because somehow the rest of the world is using it).
Every plugin has an arbitrary DSL that you have to magically know by piecing together enough snippets. At that point, no one is actually intuiting anything based on the beauty of the DSL, every build is a frankenstein of different snippets that were pasted from different versions of gradle blog posts or SO posts.
And if you do get it o work then the DSL changes, or it isn't compatible with another plugin.
I just want to write a fucking integration test in Kotlin. Can I just add an `integrationTest` task in `tasks` right next to `tasks.test`? No, obviously it goes in the `kotlin jvm() compilations` section, DUH.
The first thing anyone in the universe should have asked is "how is this better than literally hand writing a makefile"? At least then I would be able to see the commands that it ran.
Now I'm googling how to make the new jvm-test-suite plugin work when you're using the Kotlin plugin but every single result on Google for `jvm-test-suite kotlin` just returns the docs for jvm-test-suite (whose snippets obviously didn't work in my project) because those doc pages have "Kotlin" written above each of the gradle snippets.
Please just end this.
Oh and dev rant sucks too. It thinks anything separated by dots in a url.2 -
Think I spent 3 hours today trying to get docker to watch my files
I have concluded that, probably, this feature is too new and buggy and they shouldn't have released it
Maybe my googlefu sucks now idk
Also can the docker docs just get to the point, why do I have to click like 12 links deep and why are there multiple pages saying the same thing. Is Google behind this? Because this reminds me of Google's terrible documentation.1 -
Why the GMail API docs and example were sucks, thats totally not cool! Yeah I need your API right now, but wtf is this docs, its so fcuking ugly. Even my swagger generated docs much better than this... Arrrrghh!2
-
Started freelancing via agency as android dev for this client. The product is a kyc mobile sdk with a flow of around 20 steps for identification. My job is to maintain the sdk/fix bugs/add features and so on.
Communication seems to be so fucking terrible.
For example the product owner is not technical and sucks at defining issues.
QA sucks at testing and providing feedback. Backend sucks at documentation and seems to live in a parallel universe, swagger docs are outdated. Previous android dev whom I replaced gave me 2 hours of his time during his last month in the company, answered some questions and then left today (which was release day) with around 6 bugs hanging. Now because we are behind schedule the PO is grilling my ass so I would provide hourly estimates, while I dont even know the codebase yet since I spent maybe 30 hours on it in the last month.
What a clusterfuck. I feel like Im in a kindergaden where people are either lazy or incompetent. It seems that sweet gig of 40 hours a month will become much more hours or my output will be low :)2 -
some recent discoveries of mine:
- DOS FDISK has totally-undocumented CLI (partitioning with auto-format and OTF drive mapping... like one OEM used it for their machine recovery discs and no one else even knows it exists) docs coming soon (this is a lie i found this a year or two ago but forgot till yesterday)
- nuitka is a fucking blessing and the man who made it deserves so much love for it
- my existence is one massive waste of time
- apparently some B450 boards require you to hit a button and test your fans' min/max values and it takes like an hour and IT STILL DOESN'T MAKE THEM VISIBLE FROM THE OS ASROCK YOU FUCKS
- the new Ryzen took my latest project's compile time from 30 hrs to like 6 because I can compile 12 things at once instead of just 4
- installing debian sucks ass now, they forgot to push part of apt to the 10.3 stable installer so you just can't install shit through apt until you fix that, though dpkg works
- apparently they pushed a grub-efi-amd64 version that breaks all efivars??? i know debian sid is like meant to be unstable but a bug like that should never have even been rolled into a package till it was fixed like ???????????
- depression sucks ass11 -
I've had it with discords interaction API. The docs are vague and cryptic at crucial times and overall it sucks balls. I've been trying to build a framework for myself around this, but this shit is impossible to do without hacks or inconvenient at best to work around and the worst part is that the discord quality assertion or anyone trying to bring some quality back into this mess has left a long time, so it will stay like that for an even longer time. FUCKKK!
-
Terraform + helm-chart ... I really ned a break. Who the fuck invented this shit.
The HCL format sucks
The documentation sucks
The dev tools suck
The debug output sucks
But I'm ok with that, I can manage.
But today really it shot the bird ... I can't have a fucking comma in a string? Because idk why the fuck helm-release tries to parse that fucking string and wants to make an array or whatever out of it? Why, you fucking abomination?
Something in the docs? Nah, who reads them anyway.
Because you know it's totally not strange that a string is analyse and oh wait there's a comma in it, the dev surely wants me to make an array out of it, because you know ...
So now I have to escape my fucking comma to prevent it to parse my fucking string. I just want to have a fucking string you hideous monstrosity ....1 -
Bluez Sucks!
I'm trying to reverse engineer a BLE device.
And bluetoothctl keeps getting stuck with 'InProgress' error after 2 or 3 write requests.
I have to restart Bluetoothd each time.
Docs are even worse (or inexistent) -
docusign signs sucks
adobe mobile sign app wount login from my app
google docs cant sign imported pdf's
wtf 😅 is everyone trying to stop me from working. i don't want to print sign and scan -
I now know why Google Clouds sucks compared to AWS, and Azure.
1. No free tier
2. Pricing is confusing and designed for comp scis
3. Too componentized.
I wanted to translate text in an image like Google Translate/Lens.
Google: after a long search of the site's developer docs, I need the Translate and Vision APIs which have separate pricing specified in hours and task type
Microsoft: search Translate API,
Does images, first 5 million characters are free8 -
I point out to a guy which documentation and which section he should read to solved his problem, 30minutes later I swing by and the dude sits and watches tutorials on YouTube. I ask him "did you figure it out and solved the problem?", he replies " nah! This tutorial is really great, it shows step by step...blah blah.. I can send it to you! We should all watch it tomorrow after standup" ... Really? He honestly believes were getting paid to drink latte watch tutorials on YouTube? I almost imploded at that point, went into "whatever"-mode and seriously pondered how much mentoring sucks some days. But seriously tutorials on the tube were targeted for 14year old beginners a last time I checked,did the world do a double revolution and left me behind?? Or is that guy just plainly trying to hide the fact how incompetent he is at reading docs?
-
Laravel docker ports configuration sucks. There is no fucking documentation in fucking laravel docs how how to fucking configure ports. I have set wrong port, wrong host with my docker setup and it was just giving fucking stupid error where lot of stackoverflow solutions do not help. FInnaly I found the solution here https://stackoverflow.com/questions...
which finally helped. So the host needed to set to the mysql instead of fucking localhost - I had found this in another SO answer but it was not enough. How the fuck can I know. Why it is not written in documentation. https://laravel.com/docs/8.x/...
And then port - it was needed 3306 - how the fuck could I know that I need it instead of 3000 which I have set in docker setup? Wtf.
Finnally when I made query "laravel docker what mysql port to use"
then I found this stackoverflow answer. Why need to make things so hard? -
Fuck xrdb and it's shitty documentation. Why is it so hard to setup pywal ? Why can't you put simple docs? Configuring anything sucks!1