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 - "no documentation"
-
Got my hands on an interesting API.
Look around on the site.
No documentation. Like, nothing. Not even examples.
Tried calling it.
Response code: 200 OK
Body: Unknown Error.
Well, fuck you too.17 -
Phone rings
Uh oh
Answers the phone
Its my boss
>the latest tool you made isnt working
Um... Yes it is?
>we cant run it because its a jar file
Um..
>how to you run a jar file?
Um... You click on it?
>it doesnt work, nothing shows up
(Maybe if you fucking read my documentation, you would see that it just generates the files you need)
>there are no files
Yes there are we tested on every possible hardware, theres no way to fuck it up
>there are no files
Okay maybe you just dont see them on your desktop, move the jar to an empty folder
>how do i do that
*hangs up*26 -
Yesterday I had to modify a python script that was written by the previous dev,
There was no documentation to understand the code, I had to read 10 files almost 900 line each, after a looooooooooong 7 hours, at the top of one of the scripts, the author name was same as mine
😂😂😂😂😂😂😂😂😂6 -
Every fkn 3 to 4 days, some random dev shows up in my office really really fkn confused and frustrated about something he doesn't understand - because I have a dark secret.
Sometime, in cold lonely nights, when no one is watching, I write my documentation before the actual code.
Somehow, sometimes documentation without code attached to it makes it to production.
Today someone yelled at me for wasting his time because he wasted 3 hours trying to find the code the documentation belongs to - and demented I stop the practice from now on.
Agh.13 -
"there's a problem with your API"
Me: "why?"
"I get no data"
Me: "what response code are you getting?"
"405 - Method not allowed. But only on the /version endpoint"
Me: "Soo... What request are you sending?"
"POST"
WHY THE FUCK WOULD YOU SEND A POST REQUEST TO AN ENDPOINT THAT **GETS** THE VERSION OF MY API???!!!!
Me: "Read the documentation. It's there for a reason"13 -
Me: Can we do this with your module?
Creator: Yes
Me: How?
Creator: By adding the need values. Please see the docs. :)
Me: You have no documentation on this feature besides, "yes."
*Creator has closed ticket.*4 -
So everyone is sharing their work again, so here is mine.
And no 6 monitors, 1 pc isn't overkill.
Well...
Maybe...
But just a little!
Usually, one is spotify, one iChrome, one development (center bottom), one execution of dev, one email&facebook split and one documentation.24 -
There is no shame in using google to program.
'Back in the day' we had phonebook sized books of documentation on our desks we would reference constantly.
Why?
No one is going to memorize a phone book sized book. Not to mention three or four of them.
Being a good dev is about creativity, not memorization.12 -
This genius made his very own super-flexible-and-versatile-never-seen-before-mvc-framework, with no documentation about the code, instead of just donwloading and implementing a popular one.
He left the company.
I maintain it.
Fell my pain.18 -
The company I work for...
Has:
1. No CI/CD
2. SVN instead of GIT
3. Outsourcing to India (oof)
4. No Automated Testing
5. Uses Bugnet (ancient, outdated)
6. No clearly defined code standards
7. No real documentation on the code
8. Rubbish code
9. No desire to reduce technical debt
10. Poorly maintained DB
11. Poor outdated equipment
12. A useless PM
13. Still priotizes IE support (??)
On a scale of 1 to 10 how fucked is this company and anything they develop?41 -
Newspaper: This CEO is one of the top entrepreneurs in the country, a true tech visionary shaping the future.
--- 3 months previous ---
Lead dev: O2 have said they are will pre-install the app on all their Androids but they need documentation from us.
CEO: documentation? on what?
Lead dev: Our unit test coverage, bugs found / fixed, security scan results, performance assessment, if and where its storing any data etc.
CEO: Ah were not doing any of that crap, bloody unit tests, its not necessary, tell them no.
lead dev: ..... eh ok
O2: *approved*
... true visionary, well done to everyone involved.3 -
There are a lot of things that could rank up as the worst about being a dev, such as recurring meetings, documentation, shitty requirements, pm gnats, Monday, etc...but something that truly ruins it all is NO INTERNET CONNECTION.5
-
NO FIREFOX AND CHROMIUM, I ALREADY SET THE FUCKING CORS HEADERS CORRECTLY ACCORDING TO THE OFFICIAL FUCKING NGINX DOCUMENTATION. WHY THE FUCK ARE YOU STILL DISALLOWING CROSS-ORIGIN REQUESTS?!23
-
"I want my API to return insults as error messages if they forget shit"
Uh no, I prefer helping them out by writing proper documentation than sending a giftbox with me flipping them off like Linus Fucking Torvalds for their spaghetti usage of your API5 -
Started working at a large company with promises of a great framework, stable environment and bleeding edge tools, decentralised working environment, only to find visual studio 2010, no git, no project management tooling whatsoever, all documentation stored on svn, no slack or other modern communications platform, still using uploaded word documents as documentation for projects and meetings, so yeah I can truly say :/11
-
Hello, I just want to let you know I'm working on a 15 year old product and it is currently in production.
It uses Angular.js and one of the earliest versions of React.js. I cannot use ES6, we don't have Babel, no JSX syntax, no CSS preprocessor. No webpack.
I must support browser since IE6 with an ES3 syntax. (luckily I got some some polyfills for an ES5 syntax)
When I build a component I have to call React.createClass and React.createElement.
The render() function is basically a nested pile of React.createElement.
There is no documentation for this product, no tests, no anything.
I had to reverse engineer it in order to understand how it works.
The code base uses mixed programming styles and naming conventions, plus thousands of little js files.
Oh and obviously no hot reload, every time I make a change I have to restart everything.
Please, send help.
I'm in danger.
Sincerely,
An underpaid developer
....
I'm not crying, you are crying...19 -
I started coding in 1994 making .BAT menus for my DOS games. Used HELP.EXE to find commands I could use. Then I figured out how to modify and run GORILLA.BAS (using Q-Basic). Man, when I realized that all BASIC commands were in the OS documentation as well, that was the Red Pill! Just started to copy commands and blocks from the Gorillas game into a new program, read the doc, modify, run and learn. Btw, the first BASIC command I played with was "PLAY" (for music).
At that time I was 10 and there was no Stackoverflow, no Youtube, no tutorials, no Google... no easy path to follow down the rabbit hole.
Ref: https://en.wikipedia.org/wiki/...10 -
1. No more coding on paper! Why can some already write essays on laptops but programmers are stuck with "analog"?
2. No vendor lock-ins! Teach free, cross-platform development, not VB.NET.
3. No more professors stuck in the eighties! If all you know is 6800 assembly, GTFO. I heard NASA was hiring...
4. Enforce code style consistency, proper documentation and even VCS for larger projects
5. Algorithms -> scripting -> programming. Don't quickly explain the basics, then throw students straight into Java.10 -
TFW your client's git policies are so draconian that the dev teams use "develop" as trunk, and completely ignore the release process.
I wrote up 50 pages of git standards, documentation and procedure for a client. Bad indian director 9000 decides the admin (also Indian) who specializes in Clearcase and has no git or development experience is more qualified to decide and let's him set the policy.
FF to today:
- documentation, mostly contradictory, is copy pasted from the atlassian wiki
- source tree is the standard
- no force pushing of any branches, including work branches
- no ff-merge
- no rebasing allowed
- no ssh, because he couldn't figure it out...errr it's "insecure"
- all repos have random abbreviated names that are unintelligible
- gitflow, but with pull requests and no trust
- only project managers can delete a branch
- long lived feature branches
- only projects managers can conduct code reviews
- hotfixes must be based off develop
- hotfixes must go in the normal release cycle
- releases involve creating a ticket to have an admin create a release branch from your branch, creating a second ticket to stage the PR, a third ticket to review the PR (because only admins can approve release PRs), and a fourth ticket to merge it in
- rollbacks require director signoff
- at the end of each project the repo must be handed to the admin on a burned CD for "archiving"
And so no one actually uses the official release process, and just does releases out of dev. If you're wondering if IBM sucks, the answer is more than you can possibly imagine.11 -
Task:
- Replace a 4 year old PHP API.
Old API:
- PHP script writing PHP scripts to /var/www/ for every endpoint needed
- Answers everthing with 200 (not even 404)
DB:
- MySQL 5.6
- ~ 1000 Tables, NO FUCKING FK's
Documentation:
- "Wasn't worth the effort"
New API:
- Not allowed to behave any different
.
.
.
😭17 -
University logic - Provide outdated curriculum. Drop current relevant stuff from the course. Use a legacy software that has no applications anymore. Expect the student to be a master at a technology without documentation.5
-
Published a well documented and tested API with project examples for basic use cases
- "Yeah we didn't use yours because we didn't know how to use it"
- "Did you look at the documentation or code examples?"
- "What where?"
- "In the repo you just cloned"
- "Yeah no <random guy> found a hacky way of doing what we want, his thing just works"
- "I..."4 -
The previous developer left no fucking documentation of how he developed this fucking website. Did I mention no one else in the company knows how he developed this fucking thing.
Fuck.7 -
I am sure this has happened to all of us in some extent with some variations.
Colleague not writing comments on code.
Ask him something like "How am I suppose understand that piece of garbage you have written when there is no comments or documentation?"
This keeps happening for a long time. Some time after, I write a kernel module using idiomatic C and ASM blocks for optimizations (for some RTOS) and purposely not write neither documentation nor comments.
When he asked for an explanation, I answered to everything he questioned as general as I could for "that trivial piece of code".
After that he always documents his code!
Win! 🏆4 -
Ironically, the face I make when a project has no documentation is the same one I make when someone asks me to write documentation.1
-
TLDR; I am a piece of shit who writes no documentation or no information whatsoever when I am doing something.
Created a custom version of Windows for our company couple of months ago. Before leaving, I am supposed to pass this valuable information to another new developer.
Obviously, since it has been a long time I have worked on that, I have forgotten a lot of core principles. The process is also automated in Jenkins so never really had to touch it again.
Now that I am about to explain the process to the new recruit, I realised that I have written nothing about that process. No documentation, no information. The only thing I have is a bunch of scripts automating everything for me. WHY WHY do I do this to myself :(17 -
Let's start 2023 !
WHO THE FUCK imagined that having language like YAML is a good idea ??
Fuck you and your spaces. No editor produce any decent errors messages except "Your spaces are wrong".
When you edit an Azure debops pipeline, it's just 5 min ti do thing, 35 minuites to figure ou where to add/remove spaces.
NO, I WILL NOT read 25 pages of documentation to add a single step into pipeline.
Fuck YAML !29 -
Yesterday I had to ask a classmate what the arguments of a method were (no documentation).
He said: "Uhmm it doesn't matter in which order you put the arguments into the method?"
No more to say.5 -
You have a question.
You google it; nothing comes up.
You read the documentation; no good.
You ask it on stackoverflow; no answer.
You are in... The Twilight Zone4 -
Today a new person joined the team.
Started bitching about the entire team for not having documentation for our already written code and software.
Asks the manager for a new task that he can take up so that he can write documentation for all our already coded works.
Manager says Go On.
Troubles me with 400 questions every 3 minutes in the name of Knowledge Transfer for writing his documentation.
Sends a proud mail to the team for writing this new documentation that no one else had time to do.
He is a newbie and had no other task to do anyway.
I seriously don't know if I should feel proud of him, for writing new documentation,
Or if he's doing this to defame me.
The team is filled with snakes.15 -
So I've been doing some code jobs now and recently they pushed me to a new level.
This company worked with some silly management app made in cpp which they asked me to edit a little bit giving it another style and some additional functions.
Day 1: this code is a mess.
Day 2: this code is a mess.
Day 3: how does this code even compile.
Day 4: I no longer have faith in humanity.
Day 5: I found my first comment (Yay?).
Day 16: I'm done.
Day 19: I got paid.
If you're making a project in cpp just like that dev you do deserve a punch in the throat.
No documentation, no comments, no patterns, just some thick pasta of poorly written code, names like fCalcAllTaxFilesSizeMB....
This haunts me for real.2 -
New job...
No introduction to project
No database overview
No documentation
No commented code
Shit, hope this isn't normal in the industry I have aimed the rest of my life at9 -
I've been lurking on devrant a while now, I figure it's time to add my first rant.
Little background and setting a frame of reference for the rant: I'm currently a software engineer in the bioinformatics field. I have a computer science background whereas a vast majority of those around me, especially other devs, are people with little to no formal computer background - mostly biology in some form or another. Now, this said, a lot of the other devs are excellent developers, but some are as bad as you could imagine.
I started at a new company in April. About a month after joining a dev who worked there left, and I inherited the pipeline he maintained. Primarily 3 perl scripts (yes, perl, welcome to bioinformatics, especially when it comes to legacy code like is seen in this pipeline) that mostly copied and generated some files and reports in different places. No biggie, until I really dove in.
This dev, which I barely feel he deserves to be called, is a biology major turned computer developer. He was hired at this company and learned to program on the job. That being said, I give him a bit of a pass as I'm sure he did not have had an adequate support structure to teach him any better, but still, some of this is BS.
One final note: not all of the code, especially a lot of the stupid logic, in this pipeline was developed by this other dev. A lot of it he adopted himself. However, he did nothing about it either, so I put fault on him.
Now, let's start.
1. perl - yay bioinformatics
2. Redundant code. Like, you literally copied 200+ lines of code into a function to change 3 lines in that code for a different condition, and added if(condition) {function();} else {existing code;}?? Seriously??
3. Whitesmiths indentation style.. why? Just, why? Fuck off with that. Where did you learn that and why do you insist on using it??
4. Mixing of whitesmiths and more common K&R indentation.
5. Fucked indentation. Code either not indented and even some code indented THE WRONG WAY
6. 10+ indentation levels. This, not "terrible" normally, but imagine this with the last 3 points. Cannot follow the code at freaking all.
7. Stupid logic. Like, for example, check if a string has a comma in it. If it does, split the string on the comma and push everything to an array. If not, just push the string to the array.... You, you know you can just split the string on the comma and push it, right?? If there is no comma it will be an array containing the original string.. Why the fuck did you think you needed to add a condition for that??
8. Functions that are called to set values in global variables, arrays, and hashes.. function has like 5 lines in it and is called in 2 locations. Just keep that code in place!
9. 50+ global variables/hashes/arrays in one of the scripts with no clear way to tell how/when values are set nor what they are used for.
10. Non-descriptive names for everything
11. Next to no comments in the code. What comments there are are barely useful.
12. No documentation
There's more, but this is all I can think to identify right now. All together these issues have made this pipeline the pinnacle of all the garbage that I've had to work on.
Attaching some screenshots of just a tiny fraction of the code to show some of the crap I'm talking about.6 -
PM, on kickoff meeting: good code speaks for itself, need no documentation
PM, on UAT day: how does this features work, where is the documentation for it?
Dev: Just do me a favor and go fuck yourself.1 -
My current project is a fucking nightmare.
It started in 2007, using a solution developed by an Indian company due to outsourcing (aka low-quality code).
It's running on Java 7 on the back-end and its front-end side is pure Javascript files. There are thousands of little .js files everywhere, no documentation, no comments, differents coding styles, outdated API that were already outdated at the time, mixed oop and procedural.
Not even when I started coding, I wrote something so horrible.
Yo, it's a clusterfuck and I just wanna get drunk.5 -
TLDR: crappy api + idiot ex client combo rant // devam si duška
I saw a lot of people bitching about APIs that don't return proper response codes and other stuff..
Well let me tell you a story. I used to work on a project where we had to do something like booking, but better..crossbreed with the Off&Away bidding site (which btw we had to rip off the .js stuff and reverse engineer the whole timer thingy), using free versions of everything..even though money wasn't an issue (what our client said). Same client decided to go with transhotel because it was sooooo gooood... OK? Why did noone heard of them then?
Anyhow, the api was xml based.. we had to send some xml that was validated against a schema, we received another that was supposed to be validated againts another schema.. and so on and so on..
...
...
supposed..
The API docs were nonexistent.. What was there, was broken English or Spanish.. Even had some comments like Add This & that to chapter xy.. Of course that chapter didn't even exist yet. :( And the last documentation they had, was really really old..more than a year, with visible gaps, we got the validation schemas not even listed in the docs, let alone described properly.
Yaaay! And that was not everything.. besides wrong and missing data, the API itself caused the 500 server error whenever you were no longer authenticated.
Of course it didn't tell you that your session was dead.. Just pooof! Unhandled crap everywhere!
And the best part?! We handled that login after inspecting what the hell happened, but sent the notification to the company anyways.. We had a conf call, and sent numerous emails explaining to them what a 'try catch' is and how they should handle the not authenticated error <= BTW they should have had a handled xml response for that, we got the schema for it! But they didn't. Anyhow, after two agonizing days talking back and forth they at least set up the server to be available again after the horrified 500 error. Before, it even stopped responding until reset (don't ask me how they managed to do that).
Oh yeah, did I mention this was a worldwide renown company?! Where everybody spoke/wrote English?! Yup, they have more than 700 people there, of course they speak English! <= another one of my ex clients fabulous statements... making me wanna strangle him with his tie.. I told him I am not talking to them because no-one there understood/spoke English and it would be a waste of my time.. Guess who spent almost 3 hours to talk to someone who sounded like a stereotypical Indian support tech guy with a flue speaking Italian?! // no offence please for the referenced parties!!
So yeah, sadly I don't have SS of the fucked up documentation..and I cannot post more details (not sure if the NDA still holds even though they canceled the project).. Not that I care really.. not after I saw how the client would treat his customers..
Anywayz I found on the interwebz some proof that this shitty api existed..
picture + link: https://programmableweb.com/api/...
SubRant: the client was an idiot! Probably still is, but no longer my client..
Wanted to store the credit card info + cvc and owner info etc.. in our database.. for easier second payment, like on paypal (which he wanted me to totally customize the payment page of paypal, and if that wasn't possible to collect user data on our personalized payment page and then just send it over to paypal api, if possible in plaintext, he just didn't care as long as he got his personalized payment page) or sth.... I told the company owner that they are fucking retards if they think they can pull this off & that they will lose all their (potential) clients if they figure that out.. or god forbid someone hacked us and stole the data.. I think this shit is also against the law..
I think it goes without saying what happened next.. called him ignorant stupid fucktard to his face and told him I ain't doing that since our company didn't even had a certificate to store the last 4 numbers.. They heard my voice over the whole firm.. we had fish-tank like offices, so they could all see me yelling at the director..
Guess who got laid off due to not being needed anymore the next day?! It was the best day of my life..so far!! Never have I been happier to lose my job!!
P.S. all that crap + test + the whole backand for analysis, the whole crm + campaign emails etc.. the client wanted done in 6 months.. O.o
P.P.S. almost shat my pants when devRant notified my I cannot post and wanted to copy the message and then everything disappeard.. thank god I have written this in the n++ xDundefined venting big time issues no documentation idiot xml security api privacy ashole crappy client rant11 -
That moment when you quit your job where you worked for the past 4 years and you have your last 5 days at work when your supervisor says that it's time to improve our documentation. Oh really? Wtf have I been saying all along? We have almost no documentation at the moment, so I expect lots and lots of confusion once I'm gone...confusion or phone calls to me.3
-
> raw http request injected in the model
> 400 lines long method, followed by three 300 lines long methods
> no autocomplete, no comments
> code called by the whole application, I mess up once there's at least 150 other components that might break
> no documentation, no tests
> pyramid of doom, 13 levels of indentation
Those are the same people getting all puffed up because the cat dared to sit on my shoulder during a call. Management focused on the real fucking problems, no doubt.rant 1 your mother gorges herself 2 with the most vilesome dicks in the kingdom 3 in rows of 250 each4 -
No matter how much documentation you write, and how well you comment the code, the truth is always the code itself.17
-
Thanks to the developer who decided to release his library with no documentation and hard coded values .. 10 hours well wasted !2
-
I'm gonna decline the next time someone asks me "hop in chat with them" to discuss their stackoverflow problem.
I'd already given my two cents about the problem in question and I thought something was unclear about that so I say okay what the hell, made a chat room and invited him in.
Him: So I have this OTHER problem with [insert JS plugin]
Me: ... I don't know enough about it. I've used that specific plugin maybe once. The question I offered you my help with was PHP.
Him: Yeah but can you take a look really quick?
Me: I'd have to reread the documentation. I literally don't remember how to use it.
Him: No problem, here's the documentation. I want to do X, Y and Z.
Me: I don't think you can X without doing A and B first.
Him: I was told not to do A, so how can I do X, Y and Z?
Fucking hell I'm not gonna do your job for you. You know english. There is documentation available. Just read it and at least try things.2 -
No documentation. Thousands of lines of code. Still learn enough about the solution to make a required change in a day. Now the company feels like I should be the one to lead training for the module, and I still don't know what the other half of the code does. T-minus two hours...2
-
Ask a developer to code entire night
Developer:
😏🤓No Problem. I was born to play with fire 😤😎
Ask a developer to complete the associated documentation in next couple of hours
Developer:
😳🤬🤯 Better call the devil to take me to hell 😱🤒🥵6 -
Went to a Hackathon, the platform looked like bs and the documentation was mehhh. So spent the time sleeping, waking only to eat Pizza :3.
(Know it was bs when no one cared >.>)2 -
For god fucking sake, PulseAudio, write a usable fucking documentation for your library and remove idiotic silent exit(1) calls and properly log what the fucking issue was
I'm tired of debugging this piece of bull shit for over a month now already while the pulse library occasionally crashes for no apparent reason29 -
Both apps I'm working on have legacy code:
iOS app has 100's and 1000's of lines of code with no documentation, no proper naming conventions and cut and pasted code off the net.
Android app has skeleton code from a Spanish taxi app + remnants of a funeral webcasting app, there's also the same no documentation, bad naming conventions and cut and paste code off the net.
The server is also as bad, it had methods that we're never used, I for one don't fully understand the server but from what I can see it's a mess.
I had a hard time understanding both apps and gladly majority of the modifications I made we're not including existing stuff, so I guess I just basically pilled my code onto of the already existing software.
I would have gladly started from scratch given the chance.8 -
Holy fuck is learning new frameworks frustrating.
I'm trying to setup a simple fucking flutter app and all their tutorials are basic shit with no auth/complex routing.
Any feature of flutter that's not in a tutorial has absolute shit documentation with 0 examples on how to use it.
Material app has like 20 properties and if you click on something like on generate there is shit for knowing what the fuck it's expecting.
Stackoverflow has a ton a code but that's just it, code. I have absolutely no idea how they generate the code they have from the documentation on the site. They must have been following flutter from the start.
Ahhhhh! 😠13 -
- I am leaving the company, so you will work on my project.
- (looks at code) But there is no single doc string or any documentation apart from the installation guide.
- Yes, but the project is really easy to understand.
... I will just sit here trying to understand your code instead of doing actual work. -
I have a lab at uni where my lab group have to refactor some code from an open source project. We got assigned some Apache project and jfc that code is a mess. Little to no documentation, hard to navigate, tests that you have no idea what it's testing, and so on. On top of that the teacher expects us to spend more time than we have on it. I'll be glad when this course is over :))5
-
In the royal city of Aagra. My phone broke and knowing the exploitative bitch I used to meet back then I was certain had I disappeared amid a conversation she would break up with me, so I debugged an Android 2.3 image with no documentation and shaky hands from frustration while cursing her every family member in Hungarian. (Passers-by probably thought I was casting spells on my computer)20
-
I have no idea how this code that I wrote last year work and there's obviously no documentation but thankfully I gave my classes very useful names such as "YuDoDis", "Texter467", "TheHolyButton", "GARBAGE", etc. Fucking hate myself sometimes.3
-
At my job there is little to none documentation of the software. Software is from 2000 and updated since...
Imagine the features no one knows about.4 -
No, a 33 Page README is not the better choice.
Not for reading.
Not for writing.
Compared to a /Documentation/ folder
+ good overviews / links6 -
I spent the last weeks rewriting a huge project which I had to hurriedly write a year ago. No comments, no documentation, spaghetti code. Part me was an asshole! But now I am done, all is new, everything is well commented, structured in classes with well defined tasks. Yay.2
-
Fuck Azure, Fuck Windows, Fuck Microsoft.
Half ass baked products in the market. Half the time there's no documentation. When there's a documentation it is so bad that it makes me feel like biting my teeth so hard that I am left with fucking pieces of incisors. My blood fucking boils whenever I need to deal with "POWER"shell. Fucking weaklings.15 -
Our documentation is currently stored in a VM image after the host died, meaning we have no access to anything - good times!5
-
People who complain about wordpress have probably never tried working with Magento.
I've been going through their documentation for about 3 hours now, trying to figure out how this entire system works. And I'm no where close to understanding it...9 -
When in internship you have to read 150000 lines of code to make changes and the code does not have any comments, no indentation, no documentation, no wiki. You'll be like fuck this shit. I'm outta here.1
-
"Your documentation doesn't specify what should be returned if there is no item matching the id, so currently I'm just gonna have it throw a 504"
Why on earth would you? What's wrong with you, you sick bastard?6 -
Oldie but goldie.. after my studies, I was looking for my first job and did interviews. In one of the companies, they asked me whether I knew C. Well yes, I had been programming in C. Ah no, that wasn't enough - they asked whether I was really good in C. I got suspicious and argued that there was the project documentation anyway, right? Turned out, no. The code was the documentation, as I had suspected.
Then my question - as freshman, mind you: "Do you have any plans to get to a more professional way of developing?"
The interview was pretty much over at that point, the boss got actually angry. Well, interviews work both ways, and he had failed. I surely dodged a bullet.2 -
IF ONLY DOCUMENTATION WAS IN ENGLISH
In the past I've seen documentation that is great, and documentation that is conspicuous by it's absence.
Over the last decade, I've noticed documentation is getting WORSE.
I believe the reason for this is that those tasked with creating documentation have become so accustomed to the jargon in their own heads that they have LOST THE ABILITY TO COMMUNICATE IN ENGLISH, and as a consequence simply don't bother.
New terms such as "ThingamyJig" are defined as "A Collection of ThingamyJigs" — so you end up going round in circles and get back to square one.
They make little or no effort to provide simple examples.
If only companies who create languages understood that those who wrote the language may not be the best people to write the documentation.3 -
I spent the entire freaking day on one spec — one! — and I still haven’t gotten it to pass. Or fail. It’s still just breaking. Even the simple crap is breaking, so getting the actual complicated things I need it to do working? Bloody pipe dream (whatever that means).
Just. Goddamn this system is complicated and poorly designed.
And no, before you ask, of course there is no documentation.
I want my day back. 😡4 -
no fucking documentation
no fucking explaination
and your example doesn't even work
let's just run around in circles until we all die
waiting to exit this 🤡 world
yeah, i know, everyone is like "why can't you chill more"
because this what we are stuck doing 8-9 hour a day!!!!!! this is literally our lives just wasting away!!!! and it's not even fun anymore; you can't enjoy it if everyone is so fucking incompetant any step at being productive is fucking battle
god so sick of it4 -
My boss asked me two days ago to fix some errors in an application. From the errors I saw it would be a 5 minute fix. I fixed the problems just now because there was no documentation on how to set it up.
After setting it up it was just changing a value from true to false...
I ruined two days just because there was no documentation. Please everyone, I know writing documentation is boring but at least write some documentation on how to setup a project.3 -
Sometimes, usually during the evening, I lower the lights in the living room, put some of my greatest Scotch in a glass, and stare at this fine and beautiful piece of code I wrote a long time ago that I am really proud of.7
-
I like reading documentation.
BUT I really hate writing one for a project that I have nothing to do with it.
I am charged to write a documentation just because they think I am good on expressing and structuring ideas.
F_M_L2 -
I've just realised something... I haven't ranted about work for a looooooong time.
It seems now all the monkeys have left the team and we've hired young people that actually knows how to get things done without blowing things up (though still need to work on documentation, bus factor still too high). So I'm no longer cleaning up their shit or the bugs they're too incompetent to analyze and fix...1 -
I've been working as a programmer for 16 years now, and would say I'm not inexperienced, so it's frustrating to feel like a noob after months at a new company when they have poor internal documentation, hundreds of repos with default readme, pretty much no use of docker, sub standard equipment and use their own weird software for deployment. It's hard to meet expectations under these conditions.4
-
I have finished some docs for my project.
Going to bed.
GIANT insect in my bed.
I think i'll not sleep tonight...
I prefere the doc work.1 -
Fucking piece of shit, i want to make a fairly thin app with some native functionality and
Flutter - no documentation whatsoever, what a surprise
React native - i need 3 extra modules just to do what i want
Cordova - fuck no
Litho - seems fine but i dont wanna use native, i dont even have adb on my laptop18 -
I love to code but I hate to configure.😡😡
OK I hate to configure when it takes several hours and when there is no real documentation.2 -
"A perfect implementation of the wrong specification is worthless. By the same principle a beautifully crafted library with no documentation is also damn near worthless. If your software solves the wrong problem or nobody can figure out how to use it, there’s something very bad going on. " - Tom Preston-Werner
-
Rant
I'm tired of this shit!!!
First I receive a task to create a new functionality for the app that I'm working on and some documentation (this is the only good part of all the rant) but no design.
It's been 2 weeks since I got assigned to this and still no design, no assets, no API calls that ACTUALLY WORK.
Today was testing a plist to get a banner link, and for 1 hour that little fucker didn't returned the image I was asking.
Better, I wasn't getting ANY IMAGE. Turns out that the link sends me to a HTML URL that doesn't have any image... go figure!
So I've been working on this from some images inside the PDF with the documentation given.
Oh! Wait! There's more!
The cherry on top is that I'm implementing a chat/voice call/video call into the app and the framework that I will be using is being created now, and it's not even finished!!!!!!4 -
Scouring the internet for documentation, then you find a promising google result
THEN IT'S A FUCKING FORUM THAT I HAVE TO SIGN UP FOR FIRST
no thanks -
You know what's fucking horrible?
Implementing new features to an Android app in production that another dev wrote...
...which has no architecture, no documentation, no modularity, no testability, everything runs on the UI thread, filled with spaghetti code and it somehow works smoothely so I have to not fuck it up.
Oh and I'm also a junior. So fuck me, right?1 -
So I handed in my official resignation last week as I will be changing to a new job next month. So one of the last big things that I have been working on is a Jenkins server for the rest of the team to use and currently writing up the documentation for it.
However I haven't been told who I will be handing over my work to, but the bigger thing I feel is that even if I write all the documentation, no one will actually read it. Reason I think this is because I doubt anyone else in the team will even use the Jenkins server. The major issues are that no one writes unit tests and don't even understand what CI is!
So right now it feels like my final month of work will all be for nothing and makes me wonder if I should even bother writing documentation, especially if it isn't going to be handed over to anyone.5 -
Best dev experience : found this. https://github.com/jupeter/...
Worst dev experience : learned the cons of no documentation the hard way. -
Fuck Shibboleth and its documentation, fuck examples for configuring it, ops sorry they have no examples at all so fuck them, fuck SAML fuuuuck!!!!! And I almost forget FUCK JAVA2
-
So....
I was just told why the company's code has no documentation...
Quote: "It enforces devs to write simpler/better code"
Oh and added bonus - the whole backend is PHP with a bunch of tweaked libraries.3 -
The worst part of being a senior software engineer for a team is that the legacy code of the company is not clear, and there's no documentation.9
-
React router is shit
I have never seen more retarded library.
Not only those suckers change the 100% of the API every fucking update for no reason, also they have the most fucked up documentation ever.
No search in the docs!!! Fucking bullshit examples with no such easy things like how to create nested routes.
Please, stop using this piece of shit, I'm tired of working with this fucking abomination. Hope they will delete their shit repo one day.22 -
PM: "Can you take a look at this app and see if you can find why it's producing errors and fix it"
Me: "Yea sure, can I see the documentation so I might be able to understand the system and why it's doing that?"
PM: "There's no documentation" ... "Also it was cowboy coded by an intern" -
When I got in this job:
No test, 0% coverage
No teamwork
No documentation (front and backend)
Senior doesnt want to talk
1year later:
We have test prolly 10% coverage
Still no team work
No documentation
Senior doesn’t want to talk
Ps: tried doing documentation but I cant unless my senior will help me because I dont know the ins and outs of the codebase.
I say crap.11 -
Part? The whole damn thing.
We are supposed to be practicing agile, but I haven't seen a single sprint plan till date. All we do is solve issues that are reported from production/QA.
Nobody follows proper documentation, no reviews, no proper version control... Can't wait to finish my contract here and get the hell out.1 -
Worst documentation is the one so confusing and poorly written that even no documentation would have been better. And more than small projects, large corporations who don't give a fuck *ahem* Oracle *ahem* are guilty of this3
-
The best kinds of comments:
/**
Gets user CC info datas.
*/
public Object getUserCCInfoDatas() {}
If you really want to outdo yourself:
/**
Gets user CC info datas.
@param someshit Outdated docs ftw
*/
public Object getUserCCInfoDatas(String unrelatedToDocAbove) {}
Honestly, no documentation is better in some cases. At least I can't be angry about their shitty quality... And they don't waste my time.1 -
Currently doing my final handover, the "senior" developer is trying hardly to find things for me to change not in the code, no, in the documentation. Bitch, this is the ~most~ only documented project in the whole company!
#5 days left.3 -
I've seen several rants on here about poor documentation on great libraries. Well I just spent 9 hours in a car today and I realized that even the ones that have great documentation absolutely SUCK at being mobile friendly. I'm no web developer but how freaking hard is it to optimize your stupid website for small screens??? There are a million frameworks out there you can choose from PLUS it's almost entirely text so it can't be that hard!! I have to zoom in about 300% to be able to read it, then I have to scroll back and forth because it no longer fits on the screen.
-
Whenever I have to ask about how certain code of someone else works, I feel bad. I feel like I should be able to figure it out on my own.
On the other hand, if people ask me to implement something within their code, that I am not familiar with, I kinda expect more info? Like if you don't have any tutorials or documentation on your tool, be prepared to answer some stupid questions about how to set it up and whatnot. How else am I gonna know how to start with? Having to read the entire source code is a massive waste of time, no?
tl;dr: if you don't provide documentation or tutorials, be ready to answer stupid questions.8 -
Serious question for anybody who has dared to understand manager-speak: Do you know what a 'Task Rewind' is? We have it in our documentation, but google gives me no help as to what the hell it could mean.
...Or should I just take my original gut feeling and classify this as yet another word for the clown dictionaries?6 -
- my (non-dev) supervisor at my job
- no documentation
- no source control
- people working in the same team with completely different programming/domain knowledge levels, but also very different ways of being
- bad within-project communication
Luckily not all of them are about my job. We do use source control.8 -
Yay, I inherited a project with no documentation that is soon to be out of the prototype phase in a tech stack where I have no experience. It is already sold to customers and they expect it soon.
There are so many bugs, never been code reviewed but the main functionality semi-works :(15 -
Technical debt.... so much technical debt it’s driving me crazy!
It’s not only that there’s commented out lines in abundance, methods and whole classes not used anywhere anymore in a decade and code using not only deprecated standard library functions, but some that have been REMOVED in earlier versions of the language (have no idea how those have even stayed functional...), and documentation that has very little to do with the reality... but today, I submitted a pr to fix the documentation for setting up dev env - which was outdated already when I started a few years ago!
I know we are understaffed and busy, but c’mon - it doesn’t take much to leave the code in a better place than when found...4 -
I don't know why they made so many algorithms, data structures and big O questions during interview, when all they wanted me to do was to maintain some legacy, tight coupled, spaghetti code with no architecture, documentation, tests nor any kind of engineering behind :/1
-
WooCommerce is shit
Just try to find anything in the documentation on their retarded website and you will get what I am talking about.
A billion of unstructured links. With absolutely no sidebar or table of contents.
IMPOSSIBLE to find any fuck there.
It is far easier to build an e-store from scratch, than to customize their ugly monster.
Now look Laravel or PHPunit documentation to compare how it should be. -
It's disgusting how a package like compress-commons can have 1.3 million weekly downloads yet no documentation whatsoever and not even any relevant comments in the code. Honestly fuck the javascript ecosystem3
-
Be me, get a consultant job, go to a supposedly great client that has fame of getting scouted by Google. (attn: I doubted all this shit before I started)
Learn the basics by a awesome mentor and trial/error stuff at the same time to get the hang of things, after that was done, I noticed there was no documentation whatsoever, code is spaghetti and your documentation, good luck!
Royal spaghetti, you can't make heads or tails of it, dev code in production, empty try/catch blocks, empty statements, if (true)... (incl. their core classes)
Keep in mind this is a multi milion dollar company...
Someone please understand my pain...6 -
- i = ++i or i = i+=1
- No Documentation
- Not Splitting up a Stylesheet
- function()
{ }
if(){ } (inconsistent style)
- Using a ton of if's instead of a switch
- Installing Nvidia drivers manually on Linux thrice! Had to reinstall it everytime!
- sudo rm -rf /
- Being unorganized in terms of personal projects.1 -
Working on codebase of a 20+ year old system that the company I work for bought five years ago and in that time there’s been no refactoring, no security updates, no attempt to create automated testing (there is none), new features have just been built on the codebase with no regard for quality and it’s just spun into the horror cesspool that it is today.
I joined one year ago and I’m slowly refactoring the codebase and updating it to get it to a more modern codebase, cleaner code, faster load times and creating a ton of dev documentation so the devs in India can start getting into best practices and start producing quality code.4 -
Me: "Need help with build config problems, please help almighty documentation page!"
Docs Page: "Nah fam, I got 4 headers about problems with no text, a blank code example, and 2 error 404 pages."
And that's why I don't like build pipelines. -
There is a commercially sold ERP solution that has it's DB schema in excel and Other documentations in MS Word. And its not even properly structured, no schema diagrams, last updated for a 4 year old major release 😒😫.
I have to develop a custom module for it and that requires building an ActivexDLL Project in VB fucking 6 😭😭 .
VB6
Unstructured Documentation
Legacy code
Incomplete documentation
FML
Tell me if you want ss in comments.5 -
This little underscore (actually the absence of whomst'd) was the source of a very frustrating bug.
I tried to debug the sources of a 3rd-party library to no avail, but all I had to do was to read the documentation for the 1001st time. 😤1 -
Documentation? That's the stuff of dreams for us.
Instead we have ancient code written by people who have long left / forgotten with no idea what the cryptic mess they left behind does. -
Is it normal to have to sit in hours upon hours of handover sessions for a spaghetti software solution?
There's no documentation, we have to create it, hence the hours upon hours of handover sessions.
I'm so fucking burned out from the past two weeks' meetings.4 -
Taking over development of a system from some other guy who just straight up dropped it with zero documentation. The code looks like he wrote it after watching some getting started tutorial. There is no structure. Some methods and statements are just empty. And he spelt 'connection' three different ways in the same file.
God help me...1 -
Took over a NodeJS/SailsJS project from a previous developer that is no longer working at the company. There's no documentation or requirement docs and the models need to be rewritten as some have up to 67 attributes in them.
Looked through the source code file by file to see how bad it was and it will more than likely be easier to start over then to try and refactor and cleanup the existing project into a usable state.
As bonus, I was given the option to switch the entire stack if needed as well.5 -
Angular material is shit.
Angular material has literally no documentation. There is no search on their shit docs. And there is absolutely no info in their docs about some shit they use.
So when you need to know what the fuck does smth like MatOption mean (what inputs does this piece of fuck takes?) you will need to dig into the code.1 -
How fucking hard is it to write simple documentation with everything you need to get something working for fucks sake. Several fucking hours of my life later and I'm still no closer to figuring out what the fuck is going on with something that should simple. FUCK!!5
-
no one taught me how to host anything web, i had to figure out how to get things live by myself. it was awful, documentation on that stuff sucks, but i got through it knowing far more than when i started.5
-
Yea sure, I'd like to refactor your fucking 1000 loc spagetti code "module" with no documentation at all...3
-
Coworker: So should we just make a living document to keep track of how all these objects are going to interact with each other?
Boss: No, are you kidding? No one reads documentation!
I mean... he has a point...3 -
How the fuck does a library with such shit documentation that makes no fucking sense have 43k+ weekly downloads7
-
No documentation, even if it's for personal private projects.
I still can't wrap my head around code I made 2 years ago...1 -
anyone else, when reading documentation to some API, and you come across section titled "doing [whateveritis] via SOAP", you just laugh "hahaha, no way, sweety", and scroll past that section as fast as possible? =D1
-
Create a library without writing a proper documentation.
1. I'm lazy.
2. No one is going to use it anyway other than me. -
AAAH, fucking aws. Why the fuck do you make documentation if it doesnt even make sense. I struggeled for hours to let your cock sucking Cognito work and I'm still fucking stuck. Why is there no proper documentation or tutorial available for nodejs. This pisses me the fuck off. I hate this piece of shit.
Ah... I feel better now. -
So third party devs that my employer hired to build our web based application used fucking spaghetti jQuery to validate all of it with no documentation. What a bunch of cunts.
-
So, I joined a hardware company as a software developer few months back. I'm working on a c++ code base with thousands of files and no idea what the code is supposed to do.
I got one overview of what the product is supposed to do, which contains mostly electrical engineering jargon that I have no clue about.
Now my manager wants me fix a bug in this code. I have no clue what the expected behaviour is and no documentation whatsoever, and literally no one in the entire country who understands the code.4 -
When I started this job 4 months ago, I was given a grace period of a week to "get into the groove of the code". I asked the lead dev where on pulse (intranet) the documentation was, he laughed and then resumed what he was doing. I shrugged it off and continued scrolling through the code.
A week later, working on a story, I'm stuck at why a particular function exists. I say "it would be nice if there was documentation, where is that anyway?". Lead dev replies, "one thing you should know about this company, there is no documentation unless it's API related".
Last month's retro, 80% of our (mine and lead dev) problems were related to a lack of kt, I laughed.3 -
There's no provisioning script. Code repo's there, but no configuration files. Missing folders that break the app. No documentation on what to install, what directories to create, NO instructions. Nothing. Just an empty Ubuntu vagrantbox and a git repo. Took the entire morning and then some, just to replicate the dev environment. Fuck
-
The principal developer who wrote one of our APIs is on annual leave, there's no documentation.
It's in another language.
Add some points into scrumwise for 'Deciphering hieroglyphics'!4 -
I am working for a company that has developed a custom CMS but has no documentation written for it and now no-one knows how it works... Best thing is that it advertises it in its website. Good job!
-
Almost..
I am a web developer and assigned in a project as Infrastructure Engineer AND Penetration Tester because no one is available. I survived that hellish experience, i learned clustering and other advance stuff on my own, studying even late at night, no training..just youtube videos. PM (who is currently has little to no involvement in this stage) has very little appreciation in what im doing(research, server estimates, diagramming, documentation, planning)2 -
That's the kind of project I have to work on now which was developed for a year and has no documentation at all... 😰🖕🏻👿1
-
Started a new job this week, picking up the front end development of a property management system, since they're old developer just left.
Oh my god was his code bad, inconsistent use of js versions e.g only sometimes using lambda for anonymous functions, variable names that were a single letter, no comments, no documentation, and over 30000 lines split into almost 30 js files, following the logic of it is as fun as a hedge maze with no exit.2 -
- Implemented oauth1 - no body hashing
- URL contains credentials in plain text
- Used Azure API management feature as a proxy of the our API, however the documentation was on the our API, thus exposing the API URL with no management to developers.
- easy resource DDoSing because each trial user got a DB, the registration process did not have bot checks. You could literally freeze the db instance by spamming registration requests. -
the worst documentation I've dealt with was (sadly) some I wrote myself.
We had a project - build with no maintenance agreement attached. so I half-assed the docs and tests... a year after launch we sign a support agreement and I'm struggling to figure out how the damn thing works! -
Just got handed a dozen servers. Documentation shows a (Linux) database cluster is using ldap authentication. I try logging in with my creds. No joy. I look up the root password and log in.
Not only is it not configured to use ldap, it's also not clustered.
I need more coffee. -
Apple just changed their file system to apfs across the board, but no recent documentation on the release. It automaticalky changes from hfs+ when you install the macos 10.12.4 update. In early docs it says that time machine is not supported, but surely they cant kill everyones short term backups?9
-
Trying to learn Angular and reactjs, reading up the tutorial or documentation...
Why the hell are there ten million more shit I need to look at first? (such as rxjs, Babel, webpack... and whatever the fuck they are)
Now am I supposed to master those ten million tools/libraries before I can proceed?
Of course there is no ten million but mentally it's no difference. I'm just fed up with this.3 -
Integrating Google recaptcha into my web service. For some reason it always errors, both on a production and development environment, correct domains configured, and with he simplest setup. I'm fucking lost, documentation assumes it actually works. Similar errors on stack overflow and Google groups either got no answers or have obvious issues.
Fuck this man4 -
man this google android documentation fuckin sucks shit
i have NO idea in what order to read the document
they did a great job separating components into each different category but there are a lot of categories that use the knowledge of other categories so all of them are dependent on one another
and even when i read the documentation, they explain it like this in steps:
1. do this
2. do this
3. do this
7. do this
8. do this
45. do this
83. do this
84. do this
85. do this
and for the last step, step 2357 do this3 -
The CEO just made a huge huge push-over to the developers.
He doesn't have any customers/clients and wants us to push our limits to make a Service Oriented Architecture where legacy code is needed to be revived, no documentation, and a single motherfucking mobile developer who has 3 projects already in his 1st month of stay.5 -
!rant
Nothing worse than recieving little to no documentation/requirements on a project, garbage in = garbage out...1 -
Something that really grinds my gears recently is ”black boxes”. I get a dll to work with, completly without documentation and any desceiptions. An hour later people asks me, ”so hows it going, done yet?”.
No, im not done yet and I probably wont be in any near future you fucking morons, start documenting your fucking software as normal human beings.2 -
JavaScript libs have a massive problem with quality and especially with quality of documentation and error reporting
For the entire day I've been staring at this stupid error and can't figure it out. The documentation stating that the source function sets the source dir, but not actual saying what 'source dir' means or what paths are resolved against it is no help either
npm is actually really awesome but almost every library I've tried just fucking sucks3 -
In freelance world,
Some Computer Science degree holder (from client company) explain how good are they in Software development.
But when as soon as my team and I (after got criticized by this guy for the fact that my team and I don't have a degree in computer science) review their code, the code is a bunch of spaghetti! No proper Architecture, no documentation, and everything in one class?
Damn...4 -
Just started a new job at a big co.
Expected to implement small new feature, no sweat about 30 LOC. Unfortunately no unit tests, no way to test without real data.
Spend 2 weeks trying to get it to run on the test rack. Lo and behold the entire testing system has been sitting broken for months and nobody knew. Why is all the documentation so vague!???5 -
The project with the worst documentation is always my own. I always come back to a project and have no idea what anything does.1
-
Nothing is more frustrating than working with technologies with very little documentation and no fucking resources online. Trying to debug a Program AB AIML project for hours. StackOverflow has unanswered questions.
Few more hours and I will start pulling my hair.2 -
!rant!
I have replaced a dev in a company where the project already started and it is shit! The project is directed already to fail, no requirements documentation, no proper communications, and a stubborn dev teammate.
aaaaaaaaaaaaahhhhhhhhhhhhhhhh!!!!!!
All the documents that we have right now is I am the one who created it. Like c'mmon! this project is already going for 1 year and I recently just joined the team!4 -
So I'm returning from parental leave on next week...
One of the projects I'm involved in, was at 10% progress when I left, had planning and documentation made by me, development environment and test suite setup by me and had tests and was being reviewed.
Right now it should be arround 75% progress, no longer is being reviewed, planning is not being followed and no tests have been made since I've left...
Why bother with dumb ass devs!2 -
There is nothing common about "Common Expression Language"! Google is up their own arse again creating unusable and unlearnable standards that you suddenly have to learn. There is NO documentation about this shit at all, except for the highly technical and human unfriendly language specification.1
-
Why why why the fuck would you assign the same variable name at the start of a function to completely different data? These aren't params, but variables being assigned different things, no comments, no documentation, crucial in the operation, but assigned wildly different values with different behaviors through the code.
-
When you join a project that has no testing, no component policy, a lot of css mixins, that has to work simultaneously as a pwa, android and ios app.
Oh, yes, obviously no documentation at all *flips table*2 -
Magento, it's in the same category for me as drupal, joomla, WordPress,... Bloated, slow, general pain to work with... No learning sources, cap of a 'documentation'...3
-
So you're telling me that you have no documentation, and your app business logic is made on only observables?
Uh no thanks. -
Custom php api for huge known national software. No frameworks. Not following mvc structure. No decent documentation. Im the new dev and like how the fuck should i catch up before they think im not productive2
-
Every layout goal must take hours of frustrating intuition-destroying trial and error, followed by documentation cross-examination, MRE building, upstream bug-filing, and workaround pursuits.
https://jsfiddle.net/uz5dr8h4/21/
But no, CSS doesn't suck, you're just bad at it.6 -
Just found out that I have been reassigned to maintain an in house shitty project... It's full of crap code, no documentation, has lot of duct tapes to keep the project together and 20+ open bugs and issues...
I am so happy with my current project. But my manager is always pissed off at me for no apparent reason.
Fuck this shit... Any excuse or advice to dodge this BS project? Can't quit job, I am getting payed alot here.7 -
Great how I’ve just started a new job, haven’t been given all the licenses I need to run the software, there are multiple products with little to no documentation (and by none I mean the word “Architecture” is all there is in one of the main products ReadMe file) and I’ve a year of this! How is a company that’s this big not in any way documented like! This is gonna be long 😑2
-
Let's see what's on the menu today:
* Web Application Catastrophe Special *
Includes, but not limited to:
- Orphaned server processes in the configuration management cluster
- Microservice back-end architecture with no API documentation
- Poorly implemented cache microservice with no documentation
- Stale data causing everything to be shown as down in production, despite everything running fine
Cost: 1 developer's sanity -
Took a software engineering class at my university. The class was online which is common at my school.
The entirety of the class ends up being the prof. scrolling through a google doc while sharing her screen. No watching her program stuff, no opportunities for us to program in class, nothing. Basically like reading documentation for 3 hours.
The final project? A fucking command line tic tac toe game written in python.
My group asked if we could do a tic tac toe multiplayer web app instead and she denied us with no reason
Complete waste of time1 -
no matter how many books i read about a particular technology, if i don't read the official documentation ( no matter how large it might be ) of that technology, i always feel dumb and stupid
-
"Go check out the EAGLE documentation so you know how to properly parse its generated xml files"
(The whole docs just says "sorry, no documentation" every fucking where, not just the part in the picture...)3 -
Google Apps Script is probably the worst scum of the earth I’ve come across in a while.
Shit documentation and JavaScript 1.6, really?
No wonder nobody uses this crap and has proper implementation of a vast variety of applications.4 -
Convo b/w me & lecturer.
Me: Is one line that explains exactly what it does okay?
Him: No.
Me: Okay I'll make it a paragraph explaining it a lot more in detail...Is that okay?
Him: Nope, you need to elaborate for laymen.
I don't know what more I can add. Sick of useless documentation. Any one else have this problem?1 -
Here's a fucking challenge:
Generate an MD5 hash in React Native!
crypto - NOPE deprecated, react native throws when you try to import it anyway
react-native-crypto - NOPE, needs to make use of a shim that recursively edits node_modules... hmmmm yeah you think thats a good thing to have?
react-native-fast-crypto - NOPE, no TypeScript types, no documentation in general, only supports sha512?! WTF
garbage fucking idiot tooling stupid dumbass stupid splat splat barf splat22 -
Spent all week 40+ hours attempting to get my companies application up and running using the documentation written by one of the developers. Mind you, 20+ hours pulling and replacing files. Get to the end and nothing works, contact the developer that wrote the set up guide, and he has no idea how to fix and at some point admits her forgot some steps in the documentation and doesn't know what they are. Spent over 6 hours in troubleshooting meetings with that dev and another dev and made no progress. The documentation devs answer to try and fix it every five minutes, "do an iisreset". Fuck you and the camel you rode in on.3
-
I have become the only thing I always hated in a developer. Building a project without a proper documentation.
As a solo developer in a company where I have to do database architecture, front-end, back-end, testing, NETWORKING (I am the most ignorant guy when it comes to networking), product design, there is no time for documentation.
But hey, I have structured the project, files and functions (with comment, parameters type and return type) properly and I understand what I've done even after 4-5 months without touching that specific project so I got that going for me which is nice... I guess.3 -
"I don't know about changing that part of the platform"
-"Do you see any other way?"
"No, but this one is pretty complex"
-"Would you like me not to do it?"
"No, but like, really test it, OK? It's a very complex part of the platform"
-"Would you like me to include the phrase 'this was really fucking complex' in the release documentation?"
Sometimes I think my boss is against coding :/ -
I feel like crying because I couldn't configure ERPNext on windows (Virtual Box). Damn thing showed this error "Already Registered, There were problems" and redirect me to homepage.
Hate this when there are no error codes or no proper documentation.
Tried every possible solution in past 4~5 hours. I'll sleep3 -
Is it me or most developers just write code so it compiles and passes tests?
No documentation, no standards, no "good practices", no"good design", no software principles, no performance analysis, nothing.1 -
My coworkers are great; they actually manage to solve problems in really unexpected ways.
Problem: documentation is not up-to-date with latest changes.
My fix: update it, make sure it has all the latest modifications.
Their fix: if there's no documentation, they can't complain about it...1 -
When a senior asks me, the guy who started 4 months ago about documentation on something that they’ve been using for several years. Haha, yeah bro, wouldn’t all of our job be a lot easier? I’ve been going down entire rabbit hole networks trying to find credentials and API tokens for the last month because there was no documentation 🤷🏻♂️6
-
Those anyone has created a Chrome theme?
Dunno if Im a dumbass or there is no fucking documentation.. I have seen old forums of ppl coursing google for making it so difficult (apart from the standard upload a picture bs)3 -
Trying to port a legacy Firefox add-on I didn't write to WebExtension. Failing so amazingly...
Vague explanations, no tutorials. Mdn has a nice documentation but no tutorials. What's up with that??
Also, JavaScript. And stuff I didn't write. Just perfect. 😑😑😑2 -
When you have to work with functions clearly no one gives a fuck about... because who needs documentation... like... 2 decades later!? Oh yeah sure it might change tomorrow...2
-
Your time is better used somewhere else, let the intern write the documentation. While the project was transitioning to a whole new team with no one from the old one.1
-
Service I was needed to integrate to our system had such poor documentation and a separate pricing tier to access their APIs...
... Not having it. Used Guzzle to perform both the authentication and their search page, then made wrote a function to web scrape the result.
Job done. 😎 And yes, I have no shame to say I love PHP.2 -
Losing faith in Netflix and their awesome open source projects.
Had a hard time trying to install Security Monkey : poor quality quickstart Ubuntu-only, almost no documentation, same instructions for latest (aka dev) and stable (aka prod) version, no depencies list ... oh and the UI display well only on Chrome ..
Then you surrender and just want to check the dockerized version they provide : it doesn't work neither (build fail or back end process just shut down) !!
I'm done ... -
I hope there's a special kind of hell for project leaders / execs that make the decision to take down the documentation for older versions of a software.
I know we should have upgraded a long time ago, but come on. I have no clue what's going on now, and not much to go on either! All the documentation links in the configurations just redirect to the project's github repo, and I sure as hell am not going to read the whole source code just to find the possible logic behind the issue!
Ugh... Days like this frustrate me so much...2 -
So started building a game engine in Vala using SDL2, I have never built anything from scratch and decided to do it with no tutorials and just looking at the documentation on valadoc... So of course all of the pages for SDL2 and it's sub components show up fucking blank... Well isn't this dandy .-.
-
Being dependent on people who are lazy to document but knows everything about the app you are working on is a pain in the neck. Have tried bugging them to do documentation, but no win... Grrrr.....1
-
Ok I fucking give up, does anyone know of any tutorials on adding custom languages and syntax highlighting to VS code, I followed what little readable documentation overlord Microsoft has given and still no fucking clue, help!3
-
The customer wants to migrate his old store into WooCommerce. Here's a MySQL dump with 130 tables and no documentation on how they're related.
You also have to scrape all of the couple thousand product images off their site because they don't want their old dev knowing, so you can't just have FTP access...1 -
Currently writing a long-ass new issue to the Docker/CLI repository, to tell them that their online documentation for the manifests is absolute garbage. I mean, a documentation is supposed to tell you how to run commands, not something like "Yeah you try it and maybe it'll work. No it's not the good format, you dumb fuck. Nice, bro, but if you check what changed... That's right, nothing changed. At all. For no reason. Keep trying, it's fun!"
-
Those feeling when you had a problem and no one understand you while you can't read or get the point of the documentation 😭
-
Worst documentation I've seen?
Any+All documentation auto-generator using the (XML) code comments (GhostDoc, etc).
Worthless, utterly and completely worthless. Worse than having no documentation. -
I love this documentation about System. nanoTime()
Differences in successive calls that span greater than approximately 292 years (2^63 nanoseconds) will not correctly compute elapsed time due to numerical overflow.
Can I confidently say that no service will ever break this limit?5 -
Ok, so i havent been coding in a while, but now i have somthing rant worthy!
So i was helping a project and THERE WAS NO FUCKING COMMENTS, I mean what the shit! Atleast add some comments its as easy as typing //, what has come of this world?2 -
As a tech lead i sometimes find it very hard to defend developers for no fault of theirs.
Management is completely incapable of noticing hard data like git logs or action items updated on an excel and seems to have an idea that the devs are incompetent , but the ba that sets impossible goals and crap business documentation is competent.
Should i just let the project and juniors burn.2 -
Seriously is kivy just lacking documentation on purpose.
You want a tutorial will just look at these apps other people have made I'm sure that will help.
No looking at some game code doesn't give me any ideas on how to create a basic form or a nav drawer.
Seriously are we supposed to fucking guess?
At this point it would be easier to write a gui framework than learn kivy.5 -
Does anyone have any recommendations regarding self hosted documentation/"note taking" platform/server ?
I would like something with markup support, I've looked at the awesome list for self hosted services on GitHub... But there is a lot... So does anyone has any experience he or she is willing to share ? 😇
Dillinger looks nice (https://dillinger.io/) but no idea if I can save to my server instead of locally/cloud services...4 -
Was testing an editor for writing technical documentation. Asked their support:
Hey ___, am I right in thinking you can't paste images directly from clipboard into a document?
Couple of hours later:
Hi ___, yes, you can add images by uploading them: <url>
The URL they provide has no examples of being able to paste images directly from the clipboard. provides Trying to figure out if this is yes-but-no or no-but-yes. -
Don’t you just love a senior devs that starts screaming at you if you ask a for an explanation more than once? Aaaaaaaaand there’s no documentation 😐
-
Damn, mozart, i am trying to install it for the whole day, and now when i am able to finally install it, i dont know how to compile and run a piece of code in it. Why does anyone create such a language that works majorly on emacs, and also has no well enough documentation how to work with it, if by fluke someone installed it.2
-
I just found a class in the codebase which was named "Ariadne". Coz it was responsible for holding the information of where you are on the site wrt the homepage. Talk about giving meaningful names. There was no other documentation whatsoever. You know you've serious code quality issues when you expect fellow developers to know entire stories from Greek mythology to understand the code.1
-
3ds Max Python API Documentation.
No function has a single word explaining what it does.
The Documentation seems like it is completely auto generated and while writing the API they forgot to add Docstrings....2 -
Need to use new module or pattern:
1. Read the online documentation
2. Have no fu*kin clue what I just read
3. Try for 2 hours and fail.
4. Go home and sleep
5. Wake up at 3am from a fever dream with the solution to the problem
6. Go to work and implement it in 10 min
I guess I learn when I sleep -
This is an example if stupid documentation.
//Just like magic
try {
....
WTF! THIS IS PROGRAMMING, NO FUCKING MAGIC OR MIRACLES HAPPENS.1 -
When your about to go on vacation and the day before your PM decides it's the time to ask if a bunch of never before talked about complex features have been implemented in your application... I don't know are there tickets for them or how about documentation? No? Then No.
-
Any good books/reads when it comes to analyzing existing code bases/tracing?
I recently started a job with a decade old C code base with no documentation that requires me to break apart and modularize and I’m kind of losing my mind. There’s no comments nor properly variable names...1 -
Just started working on Alexa skills ,
And I must say , feel like a dog lost in a pool of balls plastic balls, while am chained to a pole. So much I can do.. but there’s no documentation as to how things work
All the docs available are old, and I didn’t really understand how things are working5 -
Just spent 1 week following the upgrade tutorial from one framework to the next. Using their upgrade tool and following the documentation.
Finally finish the work, most things are working it just doesn't seem to work quite right. Must have missed something.
After some digging it turns out they completely removed a function that I rely heavily upon. No mention in the upgrade document, no possible work around. Every forum post about it either has no replies or it says "it's a new feature".
Well fuck you.
The whole project is now useless.
Fml 😭4 -
Would love to share my experience with tutorial hell.
A year ago, if there is no tutorial teaching me how to do something, I am totally lost and stuck for days. Then, I decided to see how people got out of it.
The answer turned to be simple, get comfortable reading documentation AFTER you determine what you are trying to accomplish.
In other words:
1- Determine the problem and the desired end result.
2- Break the problem down into multiple smaller ones.
3- Determine the end result of the solution of each of those problems.
4- Read the documentation concerning what you need to use to solve each problem.
5- Execute.
Over time, you would find the need for a tutorial much less in order to solve a problem. Plus, documentation would ideally give the optimal solution for your problem.
Would still be cool if you find a tutorial explaining something hard to grasp, but never depend on finding one.2 -
Spent the whole night trying to get a react native component to push a csv file to multer in the backend.
Tried using fetch, then dependencies, then xhr.
Realised I had to create formdata. No such documentation on the internet.
Used God knows what after 3 hours, suddenly things are working.
I'll never be able to get answers in life -_- -
Just made a damn fool of myself with a client. I handed off three projects and they had no idea what they were for and neither did I. My boss gave me these months ago. No code comments, no documentation, just some stored procedures they wanted me to actualize.
The best I could offer was to promise the client I would send a description of the projects to them as soon as my boss gets them to me. Fuck. I thought the client would know what they asked for when I showed them, but fuck me, they didn't remember. So embarrassing. 😡😡😡 -
Man going from Rust to other languages is making me go insane
Why does no other language have a high quality, standard documentation tool!? I just want to know what classes and functions you have 😭21 -
Had to fix some stuff in the documentation for my internship... boot up Windows in a VM to use Word, virtual machine crashes *twice* for no apparent reason, making me lose some unsaved progress and somehow all the pictures in the document got a read error.
Ah well, should be done with it now (:1 -
Dialogflow documentation is ABSOLUTE TRASH. Trying to run the example code? It gives you a super helpful error: `Unexpected error determining execution environment`. Uh, yes, indeed. What it means? IT MEANS THAT YOU PROVIDED NO CREDENTIALS. Because, as we all know, providing no credentials should end in an error of 'determining execution environment', of fucking course.
You want to know how to provide credentials? Think again, all examples in the ENTIRE DOCUMENTATION assume that you're running the code... from their servers. Seriously. You wanna know how to authenticate your shit? NOT IN THIS DOCUMENTATION, LOSER. You want to know what exactly is happening when you're initializing your client with `new dialogflow.SessionsClient()`? Good luck, documentation is on another platform. For .NET. Because fuck you.
Also, you think you can store your auth info in a neat .env file? THINK AGAIN, because google is above such petty things as industry standards, you're getting a .json file and you're gonna like it, HAVE FUCKING FUN.
Dear google, die in a fire.
Sincerely yours.1 -
Is there actually any frontend framework or boilerplate to just code and avoid messing around with old libraries, missing dependencies, no documentation? I'm seriously moving to plain ES6, it feels more flexible :/1
-
Writing code at work be like:
Hmm okay so if I call this facade looking for an order with a code, and the order can't be found, it will return null. Thank God this bit of code is documented...
Ten minutes later
Why is this not throwing an exception when I pass invalid parameters in...?
Two minutes later
Oh, so this never returns null. If the order isn't found, it returns an empty DTO. Fucking docs.
Seriously, the only thing worse than no documentation is documentation that lies. And that's all I get for my first project at the company, which I am having to do alone. Either no docs, or misleading docs. -
The worst documentation I've ever seen:
/*******************************************
$NAME CODE UPDATE
********************************************/
// CALCULATIONS
Followed by a dozen of of poorly named functions for complex calculations, with no comments whatsoever (save for the commented out debug statements) -
No idea, it just makes me happy. I'm happy when I'm programming :)
Well I mean, most of the time. Every once in a while I just want to kill myself because Tim didn't do his work properly and now there's no fucking documentation for his stuff.
Ignoring those moments, I'm happy when programming :) -
Swift.
First, they added features that no developer understand : what the fuck is an optional value ?
And the documentation for iOS development is horrible. It took me 5 days to understand how the fuck we can make a POST HTTP Request with this fucking bad framework.3 -
Can't really say it's the most pissed off I've been probably at mild annoyance. So for the last two years I've been stressing that in order to do my job efficiently. I need handovers and documentation. It's a ball ache I know but definitely needed.
Well after not being listened too for the last two years we now are getting a documentation process. Why? Because a lack of documentation was the leading cause to a data breach.
Yeah I've been stressing that scenario for the last two years. But no one gave a damn until it happened. -
True story:
While doing a CR stumbeled upon the following line, with no documentation attached:
CONST = "{0}{1}{3}//{4}{5}{6}//{7}.{8}" -
UI control packs. They look amazing in the demos, and are so easy to add...
And then they start breaking for no reason. Documentation is outdated. Examples never cover real world uses. There are a million versions, and the one you use is suddenly no longer available for download.
In the end you realize you could either have lived without that one feature you wanted it for, or rolled your own with much less work. -
Was given some changes a client wanted done on a site that a couple of my predecessors worked on. They were pretty basic so thought, no prob, let's get this done and move on the more important things. Open the 3000 line css file..... no indentation..., syntax errors and warning all over the place and of course no documentation. A convoluted mess. Fixing the errors would basically break the site due to all the unnecessary overwrites. Literally the worst style sheet I've ever seen.1
-
LLVM AND BISON FIX YOUR FUCKING DOCUMENTATIONS
I've been trying the whole quarantine period to make some small Bison and LLVM snippets because I've been planning to make a compiler for my own language. But I haven't been able to make a SINGLE THING WORK because these projects have the WORST DOCUMENTATION I HAVE SEEN IN MY LIFE FOR AN OSS PROJECT. Seriously, no basic references, no tutorials, no nothing. It's as if they are trying to obscure it all! I'm looking for alternatives now.8 -
I didn't think that it could be worse than in the companies I've been previously working at (last one was good btw)!but the current company has a code base for a website made in grails with an angular app and no existing developer knows how this site works - and there isn't a single comment in the code either. There isn't any other form of documentation either D:
-
Fixing a faulty plugin modification from a former developer, and no documentation, plugin provider wants payment for support...
Me crying on the side near to pull the trigger -
Code with no clear architecture, no documentation, no coding standards, no tests, many security-issues, a lot of hardcoded stuff, written by people forced to use a completely new technology stack and messing up, of course.
But we are not allowed to change anything, of course.
We have to keep coding in that style and with the tools present in the project. For uniformity, of course.
I managed to work on that code for 2 years... Recently it dawned on me that I don't give a crap anymore.
I quit, of course. -
Be me. shitty front end dev intern. React god.
boomer tech company using ASP.NET MVC frameworks. Hey energy-vampire, can you make us some sick react components???
sure.
get sent giant mvc repo. I've never used it. no documentation. no comments. nothing. just a fat app.
why do companies do this? I literally had no idea what to do with this thing. went to main guy and he had to build a .sln project, link it to some other project, setup an appsettings.json file, import secrets, and then build.
how the fuck would I know to do that???9 -
Setting up a new docker environment for developing, its my first experience with it...
Guess who drew the lucky number to do the experiment...
Anyhow... Progress is slow, cause the sys admin refuses to cooperate, feeling threatened by the thought of us devs being able to do more ourselves...
Not to mention, our servers currently are a mess, there's no common ground, it's a mix of whatever was needed at the time, no documentation at all...
This is making the whole dockerizing process so damn painfull1 -
I hate when I visit a new web framework's site and see documentation that promotes HTML tags like this:
<input type='text' name='foo' value='{{val}}' />
If you don't know enough about which quotes you should use and why... I have no faith in the quality of your software solution. -
Was working with my internship boss to implement an CI but the documentation were cryptic and no fucking support on the forum whatsoever.
So I started working on creating my own CI dubbed Blackjack CI and he posts this on the forum
https://discuss.circleci.com/t/...
But how fucking hard can it be to have fucking propped documation.2 -
This is really a rant:
The company i work for uses the wso2 enterprise integrator for message transformation and so on.
I am in charge to get this thing to work.
And i am so annyoid about this fuc**** crap software, there price it as lightweight, fast and easy to use?
EASY TO USE?????
Who the fuck there had the IDEA to use XML as configuration files.
They have kinda no documentation, even searching the web makes no sense because you only can find there crap documentation, once i searched after another problem and found my own Stackowerflow question, which had a totally different term!!
And i guess they are making no testing, i mean if i want to edit a api and i set one bracket false or so, than if i click on save, i am doomed, BECAUSE IT DELETES THE CHANGES WITHOUT WARNING ME, i mean srsly are you kidding me wso2???1 -
Working for a company using Cobol > CGI > PHP > MySQL > Django, and once again another custom rolled framework with no documentation in PHP. Basically no desire, haha.
-
I just fucking realized that ember was modifying the native prototypes fuuuuuck.
I loathe ember!! The stupid fat hamster logo looks horrible. The documentation is like, "this does that, and that does that", but they have no good examples or explanation of how it all fits together!! -
DAMN!! I feel like quitting, I am fucking tired... much work than I could handle.
fucking no options...
the worst part is the fucking poor documentation, have to hit my head on the damn wall, every time I encounter an error.
2 weeks to go...
184 files to customize!
damn, why does life has to be fucking so hard!1 -
So the project I'm working on atm and ranted about a couple of days ago... There is absolutely no documentation and the code is at least ten years old.
At least I can contact the old dev, but he's slower at replying, than reading the code through and figuring it out 😐1 -
Me : Hey I have to implement this feature but I have no idea how to do it
Co-worker : oh we have examples here on those projects
** Later, after searhcing through code **
Me : Hey, so I based my code on yours for that project, but there's a thing I don't understand with your implementation.
Co-worker : Oh, that's because it's not the same context, please use that documentation.
Me : *Seeing that the documentation did absolutely different way to implement the feature, and so I lost my time trying to understand something I won't use because misled*... okay thanks. -
Does wanting to leave a company simply because of legacy code with no documentation and too much work a bit reason? I guess it probably is as anywhere could have the same thing :) Maybe management would be better suited for me, time to take courses8
-
Experimented with embedded Rust. Fuck that. C is a brilliant small language. Trustworthy. Rust is just C++ killer, it doesn’t belong in embedded domain. Bloated syntax, verbose error handling, crap quality crates with little to no documentation.18
-
Our team has to add some features to an existing application/platform. Its a mobile application with a server handling all the logic and a database for records storage. Fairly big project, a few 1000 lines. Ohh and did I mention that there is absolutely NO DOCUMENTATION???! Why on earth would you even be like ohhh let's do this project but write absolutely no documentation for it! Why???1
-
I would like to understand xcb library by looking at the rofi (dmenu replacement) source code but there is no code documentation. How do you guys deal with non-documented source code (supposed to be easy)3
-
Finally got a phonegap app to share location when the app is in the background. The plugin documentation no where says that you cant test it on the phonegap app and that you have actually install it in your phone to test the background location sharing.3
-
I think anything from Domas (moveaxeaxeax) is beautiful, but project:rosenbridge is just a new level.
The amount of work, weeks of fuzzing and no documentation to find an entirely secret CPU that acts as a backdoor, and then watching him explain it all. It's purely amazing! -
What are some other cool jobs I can do in tech besides code?
I am hating development and the mass confusion.
backbone.radio is a node
package but ALSO and actual application for internet radio like real radio.
Is in the backbone.js documentation...NO!
It on the marionette documentation which is built on backbone.
Guess what’s hard to search for?
Fuck it man😵9 -
The boss says: "Spreadsheet structure must be the same of this other app".
There is no documentation of the other software so:
• try some different input parameters;
• compare the spreadsheets;
• find a possible (and temporary) solution.
I do not like Excel.
😤😤😤😤😤😤 -
Has anyone experienced being able to run a build of an electron app that runs successfully, then run the same app that was zipped/tar'ed and then extracted and no longer works? Currently facing a "module not found" error after the application was archived and then extracted. The code im working on is open source and has plenty of documentation if you would like to take a peek!
-
Google Gemini API for Rest is horrible. I dont know if anyone else feels this way. If you want to know how API References and related documentation SHOULD NEVER BE written that way, go check that out.
No wonder Google's GeminiAI adoption is so much lower.1 -
don't you just love it when you have to fix a system that consists on unnecessary junk code, horrible/lack of indentation, no documentation and the clients says "I don't know what happened fix it and I'll post you good"
I mean, I live for this shit man! -
I swear there is just no documentation on GTK3 themes. I'm trying to change window decorations in an existing GTK theme and there's just no info out there. On top of that my posts for help have gotten a grand total of 0 replies.
If you happen to know where I can find some info about it I would really appreciate it. -
Isn't it great when you get urgent tasks, but the documentation required for it can't be found or doesn't even exist, and the devs that worked on the project before are no longer in the company? And then the producer gives you some document that is completely unrelated?
-
i have no idea what im doing
javascript, jsx, typescript, react have some of the ugliest and redundant syntax i have ever seen
what are people's favorite reference material for them
do people recommend the official documentation, was surprised react looked better than expected for its docs6 -
Where do i learn https://rexify.org/ caveman technology?
No i will not learn it from that outdated piece of shit documentation
Why are there 0 videos on youtube explaining it?
Why are there 0 courses on udemy explaining it?
Not to mention its written in Perl so now i gotta learn Perl first???
How tf do I learn this bullshit bruh?10 -
So I'm sitting here, one monitor has a project I am working on for computing, which once done, I need to write somewhere between 30 and 70 pages of documentation, and the other screen has a half completed 6 page documentation for a game I made in Game Dev.
If I go into backend programming, am I really going to need to do all this documentation or is it just one of them things that colleges do that has no relations to reality?
(Also if I go to uni, will I need this level of documentation there too?)10 -
Learning a piece of software from an external supplier. The manual is thick like the bible. The examples fail without explanation. Trying to contact support just leads you down an endless trail of support articles. Damn right I get frustrated and bored. Can you blaim me for rather hanging around on devRant than desperately trying to work around problems in someone else's system/documentation? Yeah, I have to pull my shit together, but they have to pull theirs first.
-
Tooday i try to migrate a Drupal 7 to Drupal 8 ... I think that migrate module from drupal8 will work easily... But i remember on Drupal, noting work as expected on this Platform... I run the migration and suprise suprise content type field are off or empty and I don't have any data imported ...
Go to reports check the error message ... Try to get information on Internet hoo yes i remember no fucking documentation anywhere because Yolo i need to release 1626 modules that in beta or alpha after 5 years of development. And i dont give shit anymore.
Now i try use migrate_plus and tools to make my custom importation... Documentation not found or not finish ... Please omg please just shutup and work1 -
All mandatory tasks complete for the week, no meetings, no distractions, time to go back to the default of documentation........ahhh email just in from nodeweekly!
-
no ticket details
not giving me some useful documentation in our first conversation to clarify the ticket, that you have2 -
Fuck you, BouncyCastle. I really like you but the way you have documentation. It's annoying. Nice name. Cool project.
Here, I'm write Java Docs for JUnit tests! For every damn test case!
So damn less documentation even SO said mind your own business! It's been more than 15 hrs. Not a single reply! I died a little today. They have examples but they are not really "examples". No passion at all for documentation!
You should watch and learn from AssertJ docs. OMFG @joel-costoglia sets standards for code style and docs before pull requests. The examples are LOTR themed for god's sake. I'm not asking for fluent API. I just want docs. What class does what. A simple program structure required.
Dyn4j, deeplearning4J have wonderful docs. Why not BouncyCastle?!!!!! -
When IT/project management is like some ideology that works out on the paper but everyone is too stupid to implement it properly.
-
I am learning C++ and I want to develop my own custom ROM for android from AOSP which is Android Open Source Project. I don't know anything about how to do it help on internet is not clear and on the Android official website there is no section for documentation and people on other sites say read documentation.4
-
-assigning me a new API integration
-It should be fairly easy. Possibly in a click of a button.
-3 weeks later... End up with outdated documentation and a call with an Indian accent guy (no offence it just end up that way)
Please chose very carefully what to use and research it very well! Trust nobody but yourself! -
So I'm going to work on a project with a webapp and mobile applications. I look at this monstrosity that sends username and pass as plain json and there is almost no sparation of concerns, along with very little documentation. Please save me1
-
why the hell would you set a router's default user/pass to nothing?! like to blank... WHY!!! spent about 2 hours trying to find this fricking thing online and of course, there's no documentation, who need that shit anyways
long story short: @router_manufacturers, set the default user/pass to "admin" AND PUT IT ON YOUR WEBSITE!!!!!!!!2 -
our office software has the shittiest documentation. no problem! i love to browse all the subfolders to find where to place a serial letter template! why would someone want to do this in the first place?
if someone working in the german medical field: i can not recommend eva/viva for some other reasons as well. -
Nothing like constantly having to spend 3-5 days of spin up on trying to help another team with their microservices because they have such a severe lack of documentation that I can't just follow a readme to get their projects running. Instead, I have to bug one of their developers to help me get it up and running (because they use non-standard project setups and dependency management), delaying things even more. No matter how much I scream that we need documentation no one makes it a priority.
Did I mention these are microservices written in Golang and I'm a front end developer? And I'm being made to work on back end tasks because we have a crazy high attrition rate and they won't back fill the back end positions.3 -
Trying to use a certain library for my ORM needs. It seems that the devs 'forgot' to add decent documentation.
Also trying out another library to integrate with it. Again, no decent documentation.
It pisses me off how A LOT of Node.js libraries have the worst documentation ever, and if they do have some seemingly okay ones, they conveniently leave out the more complex functionalities. What do they want to achieve here? For people to head to their Github pages to sniff at the code?
Holy fucking shit. I hate you people. I even hate having to use these in the first place. -
No god damn documentation so I'm running blind
Anyone know where I can learn to understand firmware or whatever controls the Bluetooth in micro:bit??? -
a) No documentation. At least you know from the start where you are.
b) Light documentation. At least you might have an API reference or something
c) Badly translated but complex documentation. Had this when I worked for a car manufacturer. Docs were badly translated and actually gave you a dangerously wrong or opposite description of what things really did. It was mental! -
Documentation. I know what I'm doing here. Future me will have no idea though. Neither will the suckers who have to maintain this spaghetti
-
It is incredibly frustrating to work with SDK with no proper documentation and less community support.
I have been struggling with errors and there's no Post online by someone getting a similar layer.
FUCKING HELL SNAPDRAGON NEURAL ENGINE WHY THE FUCK DO YOU HAVE TO BE SUCH A CUNT. WHY ARE YOU THE WAY YOU ARE.
DONT EVEN GET ME STARTED ON THE DOCUMENTATION AND EXAMPLE.
I FEEL LIKE CRYING. FROM 1 WEEK IM GETTING NEW FUCKING ERRORS AND RESOLVE THEM, GET ANOTHER UNIQUE ASS FUCKING ERROR.
Kmn. -
Influxdb 2.0 and the according python client.
This is the stupidest pile of dogshit I have ever encountered. No documentation, no examples, not even for the most basic shit, im fucking done. This is nuts, working like a week on just getting a fucking connection and do some basic curd stuff.
"Id neets to be 16 Bytes long". Yeah, thanks. With Id, org, user, insurance Id?
Next time I gonna implement this bullshit in fucking assembly, so you can have your stupid 16 Bytes without any magic tricks.
FUCK -
trying to rediscover specific pieces of tribal knowledge with no documentation and no starting point...
guess I'll just start grepping servers until I find a clue -
Just wasted two hours finding out why one of our clients rest API is not working. Apparently it needs a referer header for no good reason and this is no where to be found in the documentation...
It is great that you even have documentation, but please include all basic details!! -
When the documentation consists only out of JavaDoc boilerplate, providing exactly NO additional information and just clutters the code.
-
Hello guy who develop the internal library I'm using
Just so you know, no, "idString" is not a cool name for ppl to know what they should use when you have dozens of differents ids.
And no documentation makes it less likeable.
Have a good day, you're making mine being horrible3 -
Has anyone else used the Decimal module in python?
And if so do you know why it returns
"AttributeError: type object 'decimal.Decimal' has no attribute 'power'"?
According to the documentation
https://docs.python.org/3/library/...
...theres a power() function.
Doing
decimal.power()
Decimal.power()
power(x, y)
No matter how I call it, it always returns an error indicating power() doesn't exist and I'm scratching my head.4 -
Started a new job. Saas solution 10 years old. Not a single page of documentation....... Spent last three days trying to find code connections. #nodocumentation #y-u-no-doc2
-
when you get a random DM from somebody on their first day on another team and they ask you about onboarding stuff
i'm not sure why me as i'm on another team and not even 2 months here
i guess i updated some documentation but there was no explanation for why me and at the end of a hard day of work im too done to bother asking why me1 -
No documentation available. Often has to try to identify the dev, and then get the best of his memory guidance by phone.
-
I am working on this Flask web application as a part of the recruiting process for a company I have applied to. There are so many mysql connectors out there, but most of them are either deprecated or have shoddy documentation. Finally I found one that was working, but it used
caching_sha_password2 as its authorization plugin which is no longer supported by MySQL😤😤😤6 -
Obviously worst documentation is no documentation at all when having to interface with something proprietary (source code is kind of documentation). When you have to dump exported symbols and guess what could it do and how to call it. Luckily too old (and hopefully wise) for it now, sticking to opensource.
-
Blame on ModemManager documenters not specifying any of pre-probing features.
MM is a great project, but I think they lack detailed documentation. Udev is no magic, so don't treat it like snake oil in your documentation! -
-> Not completing database structure and realizing it in the middle of project execution.
-> not using version control
-> no documentation/comments
......List goes on