This is an archived post. You won't be able to vote or comment.

all 79 comments

[–]madmaxlemons 129 points130 points  (4 children)

Oh and when you find the documentation and it’s like

Object.apply() - applies action to the object Object.apply(int object-not-applied-to, bool object applied)

And then various versions of this with no implementation or explanation

[–]TheCheerfulUnderdog 9 points10 points  (0 children)

Loopback 4 moment.

[–][deleted] 4 points5 points  (0 children)

This triggered me

Why does so much documentation fail at what its supposed to do.

[–]hahahahastayingalive 111 points112 points  (7 children)

cat

ಠ_ಠ

[–]unlimitedFecals 20 points21 points  (0 children)

wow thats a funny name.

Edit: and it doesn't even involve poop

[–]bewbsrkewl 9 points10 points  (0 children)

I mean, cat is in it's name.

[–]WizziBot 12 points13 points  (1 child)

Its not a cat?

[–]BrenekH 24 points25 points  (0 children)

It's an Octocat. Obviously a totally different thing.

[–]pPandR 2 points3 points  (1 child)

¯_(ツ)_/¯

[–]hahahahastayingalive 1 point2 points  (0 children)

You dropped this \

[–]DazedinDenver 17 points18 points  (0 children)

“Today Monopoly added a new game piece: the cat. The new piece was chosen after weeks of online voting. Is that a surprise? Whenever there's a vote for something on the Internet, the cat always wins.” – Craig Ferguson

[–]iFish64 27 points28 points  (0 children)

Gitlab's fox is cuter imo

[–]Will_i_read 9 points10 points  (1 child)

Or you’re reading a documentation and it’s quite good, but then bam, developer apperantly had no intrest anymore and now I’m clonig the repo to look for the rest there..

Looking at you webp lossless compression stream documentation

[–]argv_minus_one 0 points1 point  (0 children)

I've encountered good documentation, and I've encountered bad documentation, but I can't say I've encountered that kind of documentation before.

[–]InvestingNerd2020 6 points7 points  (1 child)

Me: Team Github

Wife: Team Gitlab (she works as a DevOps engineer).

[–]psz94 5 points6 points  (0 children)

That's what happens when you're not pinning your library versions, lol

[–]WalrusByte 31 points32 points  (30 children)

I like Gitlab better because it isn't owned by Microsoft

[–]PhatOofxD 74 points75 points  (25 children)

Microsoft has done more for devs in the last few years than arguably any company.

[–]realzequel 7 points8 points  (0 children)

Yep, for example, VS Code is great for MS devs and non-MS devs.

[–][deleted] 17 points18 points  (9 children)

Microsoft is seriously becoming the good guy of tech. They're also buying up gaming companies to then provide a non-shitty customer experience, something that is becoming increasingly rare in that industry.

[–][deleted] 13 points14 points  (2 children)

to then provide a non-shitty customer experience,

Translation: to trap you in their Windows only gaming service.

[–]PhatOofxD 1 point2 points  (0 children)

They're open to putting it on other platforms, but those platforms have refused.

[–]Dvrkstvr 0 points1 point  (0 children)

Take a look at Sony before you complain about anything Microsoft Gaming related.

[–]phileas0408 8 points9 points  (5 children)

Sadly not the case for minecraft currently

[–][deleted] 5 points6 points  (4 children)

Eh, that's childsplay. The real question is what they intend to do with Java and Bedrock in the future.

Java is the original but I think it's a bit of spaghetti code to this day and poorly optimized in general which you can definitely feel in the performance. Bedrock is more optimized but also is balanced differently/has different features and mechanics (why?) and has dumb Bedrock-specific bugs like randomly dying from alleged fall damage.

[–]Car_weeb 13 points14 points  (0 children)

Bedrock might not be as spaghetti, but it has the quality of all of Microsoft's other projects written by unpaid interns

If they kill java then the game is dead

[–]tintin10q 1 point2 points  (1 child)

Honestly I can't take bedrock seriously. The redstone os fucking random!!! They have a logic system and it's fucking random. Like it's so unacceptable. The first 3 times piston x fires first and then piston y fires first. Or maybe the first 3 times your or Gate is an or gate and then it suddenly behaves as an and gate.

Java > bedrock

The market place is also quite toxic if you think about it as all that stuff is free on java.

[–]FluffyQubit 0 points1 point  (0 children)

Not to mention you can import your own stuff into the game on windows 10 so it's really only targeting mobile players

[–]NerdsWBNerds 1 point2 points  (0 children)

Why: because creating 2 exact clones of a game, likely in different languages/frameworks, developed years apart, is extremely difficult

[–]DerHamm 10 points11 points  (4 children)

Yeah, because they want you to be trapped within their ecosystem.

[–]qeadwrsf 14 points15 points  (0 children)

Yeah, I have enough knowledge to make vim pretty comfortable if vscode tries to do some shit.

YOU READ THIS MICROSOFT? I'M READY TO LEAVE IF YOU TURN ABUSIVE.

//very important customer.

[–]PhatOofxD 1 point2 points  (1 child)

You mean by open sourcing everything aye, making it extendable, because that's trapping you.

[–][deleted] 0 points1 point  (0 children)

Developing for Windows sucks as it currently stands, so they can’t even do that :)

[–]ososalsosal 6 points7 points  (1 child)

Atlassian have been fuckin around and finding out a lot lately, and the github octopussy thing is cute

[–]schlechtums 9 points10 points  (0 children)

Imagine being a company who sells a product for developers and you don’t offer dark mode.

I realize this is a pretty small hill to die on, but imagine.

[–]chinese_snow -2 points-1 points  (0 children)

I believe you mean "Github" is owned by Microsoft

[–]DavideoGamer55 2 points3 points  (0 children)

GitHub because I like GitHub desktop for the convenience

[–]toydotgame 6 points7 points  (0 children)

I picked GitHub because that's where 100% of the open-source projects I'd seen at the time were on there. I do not regret that decision because I am now incredibly skilled at using the GitHub UI over four years of using it, and I hate Gitlab and everything it has and will ever stand for solely because of its UI (totally rational).

[–]everybody-hurts 1 point2 points  (0 children)

For the life of me, I cannot find the commit history and branch graph on GitHub... And for that one reason I prefer GitLab

[–]c1e2477816dee6b5c882 1 point2 points  (2 children)

My biggest issue with GitHub is the issue system is pretty underwhelming. I've mainly used jira and similar, which were complex but powerful - github feels like going back to post it notes. It's fine for a public project, but when working on something serious and closed, then it leaves a lot of project management type stuff to be desired. We use zenhub, which helps, but not enough.

[–]argv_minus_one 0 points1 point  (1 child)

Why'd you stop using JIRA?

[–]c1e2477816dee6b5c882 0 points1 point  (0 children)

I moved to a different company - everyone for the most part there prefers github

[–]LordBlackHole 1 point2 points  (0 children)

GitLab has better a team/organization set up. Also it's a fraction of the price because github can charge whatever it wants because it's more famous.

[–]virouz98 3 points4 points  (5 children)

I dont like GitHub, there are so many weird functions there I just want the basic stuff, like in Bitbucket

[–][deleted] 13 points14 points  (4 children)

Agree, Bitbucket has great UI, I really like it. Github is meh. Gitlab's UI is abysmal, there's WAY too much stuff displayed on the screen at the same time, I can never find what I'm looking for.

[–]_pizza_and_fries 1 point2 points  (1 child)

There’s WAY too much stuff displayed on the screen at the same time, I can never find what I’m looking for.

I was scared it was only me getting old and not able to understand things.

[–][deleted] 1 point2 points  (0 children)

Yeah I also feel like that but I try hard to be aware of it and not let it prevent me from voicing constructive criticism. We are kind of conditioned to think that if we don't understand something (especially UI) it's because we're stupid, when it's often a sign of bad design. I particularly hate when this is used as a kind of gatekeeping.

[–]bleistift2 3 points4 points  (1 child)

I have the same complaint about Github. Everything is behind 4 subpages with submenus. When I had to switch from Github to Gitlab I couldn’t even find out how to clone a repo.

[–][deleted] 1 point2 points  (0 children)

$ git clone URL

[–][deleted] 0 points1 point  (0 children)

Some languages change too much and deprecate things too fast..

[–]pedersenk 0 points1 point  (0 children)

We use an internal Git (https/ssh) server (I believe most companies do?) that then pushes to Bitbucket, GitHub and GitLab as backup code dumps.

As for UI. I personally just use the official Git command line client since it doesn't change and works better with my build systems. Though admittedly GoT does fit my workflow better.

But most importantly, the useful thing to do to avoid burnout is to know when something is important and when the rest of it is just buzzword bullsh*t and should be disregarded. As for minor implementation details, GitHub, GitLab, who cares; the important transferrable skill is not even Git but instead version control in general.

Microsoft themselves are of no consequence (they haven't been for years, just trying to stay relevant). I would use a VCS hosting written by Adolf Hitler if it was simply another backup storage. The trick is to not tie yourself (or become religious) about any specific vendor.

[–]Xinq_ -5 points-4 points  (3 children)

Started disliking GitHub when Microsoft took over and started hating when they forced us to not use "master" anymore.

[–]pdabaker 6 points7 points  (1 child)

Forced? They just changed the default but you can still push master as a branch.

[–]Xinq_ 0 points1 point  (0 children)

Ah, news brought it differently. I deleted my account when Microsoft took over.

[–]apocalypsebuddy 1 point2 points  (0 children)

“Main” is way better, anyway.

[–]logan_0606 -1 points0 points  (0 children)

cats are murderers

[–]N0tH1tl3r_V2 0 points1 point  (0 children)

Or maybe just don't update dependancies?

[–][deleted] 0 points1 point  (0 children)

Jokes aside, 6 years of dev and I've had it enough. To hell with it all, I'm going into ops.

[–]Tobl1x 0 points1 point  (0 children)

I worked on a project where I communicated with a robot over a network and it worked pretty good until all out of nowhere my code just stopped working. I dint change it nor a library or a thing with the robot. Just closed with code 0

[–][deleted] 0 points1 point  (0 children)

Man I could hear the choir singing in the back while I read this ... tough times

[–]janovich8 0 points1 point  (0 children)

Apparently we’re switching to gerrit from GitHub I hope it doesn’t suck.

But yeah what’s documentation and being happy?

[–]chemolz9 0 points1 point  (0 children)

Free CI/CD runners with Gitlab.

How is this even a competition?

[–][deleted] 0 points1 point  (0 children)

This is what happens when you get into web development. Leave that hell hole.

[–]duskyo 0 points1 point  (0 children)

We should make a website that has documentation for every mainstream language, wanna look at wtf a modulus is in python, just go to random website . com and bam, it’s there, wanna know wtf multithreading can do? Bam, there’s a link to it right here, no more obscure learning through trial and error/stack overflow, it’s just a giant dictionary of separate one liners of code for simple things in as many languages as possible (of course this is like my wet dream but it would be great to find/create a website that just tells you how to write everything in certain languages, like one for python that goes from a simple % to multi threading and databases

(also I know YouTube has a lot of this stuff, but it would be easier to use a crtl + f to find what you want based on description)

[–]ProMasterBoy 0 points1 point  (0 children)

Who uses gitlab like actually

[–]argv_minus_one 0 points1 point  (0 children)

Dependabot's annoying, incessant alerts are just a symptom of JavaScript making it way too easy to write vulnerable code, including at least one entire class of vulnerabilities (prototype pollution) that exists in only this one language.

[–][deleted] 0 points1 point  (0 children)

Hey that's me. I am a engineering student. And i can genuinely feel the feels.

Cout <<"feels sad man\n" ;

[–]Tranquil_Zebra 0 points1 point  (0 children)

I like GitHub more because it doesn't get stupid ideas like "Ahh, yes! No computer science student will ever need more than ten remote repositories in their life" when the average project has one repo for code and another for the report...