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 - "documentations"
-
She - So. Do you read ?
Me - Yes. Infact a lot. Daily. My life is filled with it.
She - Wow. Nice. So what do you read mostly ? Which one is your favourite
Me - Mostly Documentations. Vuejs documentation is my favourite followed by express and mongodb documentation. And yeah webpack. You should read them too. Then there is a book on ES6, 'Understanding ES6' by Nikolas S Zakas, famous author and programmer. Great stuff44 -
Susan, where are the fucking API docs?
Harold?
Jimmy?
There ar no FUCKING documentations for all our APIs????14 -
Manager: this is your first day in your first job right?
Me: yes mam!
Mngr: Good .. here take this system understand it and read all of the source codes.
Me: hmmm Umm ok ... where's the documentation?
Mngr: no documentations ... the contractor left without providing the documents for it so we need you to understand everything ... as we have alot of enhancements lined up for it ... and we're too cheap to hire someone with advanced knowledge on this ... goodluck!
Me: ......2 -
I remember my first "Software Engineering 2" class at University. The teacher, a pompous son of a bitch that later on gave proof of his vast ignorance, greeted us with
"so ... You call yourselves programmers, right? What's the biggest program you have ever wrote? Something along the 100, maybe 200 lines of code? ..... If you've never written at least a MILLION lines of code software, you're not a software developer"
Even at that time, with my lack of experience in software development, I had that feeling in my guts telling me "writing myself a 1M lines of code software .... Brrrr that's something I hope I'll neve have to do in my life"
Turned of he was one of those dinosaurs stuck with the love for gargantuan monoliths of software like they used to do.
Just to dive you the whole picture, the course had ZERO software development and focused only on how to manage wonderful waterfall projects, how to write all types of software documentations and the final project was ... Writing a ton of documentation so boring and useless that even he didn't care to read through.
we still laugh at the episode when another group asked us to borrow one of our documents and after one day they asked "hemm ... Have you really sent this to the teacher?" "yes, why not?" ".... at page 23 someone left a comment saying 'what the fuck is this shit?'"5 -
Add no comments or documentations whatsoever during my initial years of coding (when actually I used to write code worse than a constipated elephant's shit).. In my mind I would be like "This is quite clear-cut.. A first grader will be able to understand this code.."
But then I had to debug my own code barely some 1-2 months later and I figured out the importance of good comments and documentation..3 -
Perfect job is when sandbox and production api endpoints works the same.
Fuck all api endpoints where their sandbox works differently than the production.
Fuck all those error messages that appear only in production, despite faithfully following the documentations.
Fuck the gateways where their sandbox is more stable than the production.
Fuck the endpoints whose api parameters differ in what they accept between sandbox and production.
Fuck those manuals that does not document these diferrences.
Fuck those developers and support team who don't know how to support integrators. They don't even know how their apis work!9 -
Ooohhh I feel GDPR is seriously kicking in. And frankly I like it :)
just minutes ago a spanish photographer asked me if he could take a photo of me and use it in his expo. The photo thing took like half a minute, but we spend another 10 minutes on explanations, documentations and signing of aggreements.
Poor photographer. But I love that I know what exactly is going to happen with my portrait and my email :)
go GDPR!8 -
Being me. Fresh out of UNI with a three year bachelor in CS, no work experience. Starts in a big tech company with a lot promise of exciting project etc. Starts in 3 projects with one lead dev and two senior devs.
First month begins. I start by setting up my local environment and read documentations, which is fairly irrelevant and old. One of the senior devs quits.
Second month begins. Lead dev quits as well and the other senior dev having sick leave for the rest of the month. Basically I'm on my own, but thankfully not responsible for the projects.
Third month begins. The other senior dev is still sick. Nobody to help. Now I'm forced to talk to customer with a lacking knowledge of projects. Nobody knows what is going on. Hopefully my other senior dev will come back.
Fourth month begins. My senior have quit as well. I've been assigned as responsible of all three projects now. FML.
Fifth month begins. I begged my manager for help. Got a junior dev to help me with one of the projects. He and I still have no clue what we should do.
What a shitty start to a career as a developer.
Anybody having a similar experience?5 -
School thought me which "cutting-edge" technologies I should avoid at all costs:
"I want to fucking die" - tier:
- JQuery UI
- JSP
- JSF
- Vanilla PHP
- Java 5 and earlier
- Java and Rest
- Old Eclipse
"Mastering the art of headbanging" - tier:
- JPA
- JQuery
You may argue that some of them are not as bad as I think of them but the I was introduced to them made me despise them. We were never introduced to the documentations. Only to the sheets our teacher prepared and I think he completely pissed the point of some of them.
Rest example:
/resource/{resource_id}/action/{action_id}/username/{username}/password/{password}9 -
Teaching my little sister Mathematics (Grade/Class 12. Not at all easy).
And I can really understand the textbook definitions in the chapters. Back then, I never understood a single line of it.
Am I a more sound mathematician now or reading poor documentations has improved my skill to read complex and minimal contents!3 -
Fuck this day!
Like really fuck it!
I have one of the most terrible crunch-time i ever experienced.
I’v been working 12+ hours every day with an ever-changing project timeline.
It started simple, we made a timeline, it was risky even then but it was realistic, we started working immideatly, everything looked good then a few days in BOOM! Actually our project management completely forgot client B’s projects soo we need to do that too with the same fucking deadline!!! (About 10x more work in waay less time)
Then this morning i got an email from the graphics team that we need to document our design process RIGHT FUCKING NOW! Because management wants documentations, in the middle of a fucking crunch-time.
Today it almost got physical with my project manager, i told him that he is not a programmer, i dont fucking care about his shit, just fuck off and let me work because we won’t be ready based on his unrealistic bs.
I feel like completely fucked over, like we were told 2 days before deadline that the whole company and people’s jobs depends on us now because if we wont finish this clients won’t pay.
WE ARE TWO PROGRAMMERS for studio of 10-12 people!!!
Soo i’w been thinking about getting the fuck out of here ASAP, i got an offer from a pretty big international gamedev company just what i needed, i already did their test before all of this, i passed A+.
We scheduled a skype interview for today. I had completely no time to prepare or chill off, just got out of the office, got into a starbucks and i’m interviewing. No time to even check my mic or internet, the call was so shit i could not hear anything, they neither because the plaza was loud af. Meanwhile im nervous about work, about the interview, about can they hear me at all because of the noise. I fucked it up. BIG time! I was so done i could not reverse a fucking string in c++ or explain what is a signed int!!!
Needless to say they said no.
Need time to think about it or realize what happened? Nice dreams. Back to the office and continue working.
I can’t do this anymore. My girlfriend came for me and took me home at 10pm but all i could do was stare at the floor on the subway. I don’t want people to lose their jobs but i just phisically can’t do this anymore.
Meanwhile any time i talk to my project manager about being tired he says like “hshshsbsb i have 60 hours in the last 4 days i got the worst part, i would be grateful in your place..” like fuck off dude, i dont give fuck about how you feel about this. This is not okay for me, you did this to the project, your fucking job is to manage it! I have one day off before going back to this, i have completely no idea what to do now...
[ps: this is not Nemesys. They did not let me work on my own stuff because i would be a competitor, so i left.]5 -
Got a mini project assignment in college. We decided to make a game using Unity that recgonizes sign language gestures from Leap Motion.
I asked my colleague to make the function to compare the hand gesture, and I'll do the rest of the game. One more friend does the documentations and reports.
Three weeks passed, asked for the code but he said he hasn't finished it yet. I told him to ask me if he has any problems with it.
He sent me this 24 hrs before the deadline.
Me and my other friend died on the spot.
I screamed at him the whole night on the phone call whilsth trying to do his part in just 3 hours...
Needless to say, we didn't finish the project on time.rant compscistudent unity why are we still here just to suffer wk125 student foreach leap motion forloop assignments why do i even try -
[dec. 21]
lead: thanks for completing all the docs, i'll review them so you can do the revisions next week
[dec. 22]
me: sir, any feedback on the first few? so i can work on them while you review the others
lead: i'll send them EOD
[dec. 26]
was notified by our manager that our lead is on leave til 27. didn't get any email or anything for review points
[dec. 28]
lead: so how's the revisions doing?
me: done. if you can review them again...
almost end of day, haven't heard anything from him yet. -
I hate hearing "this should be a quick one" from the client. Especially when your code base is a fucking legacy with no documentations, no testing, and a multisite that shares the same classes where functions has some crazy if conditions just to satisfy each site's requirements.2
-
Fuck Confluence and anyone telling me to write anything there. From now on, documentations will be in the repo, written in Markdown8
-
-Writes a function that I'm going to schedule for django.
-works in development.
-adds it to production cron using django-crontab
-not working.
-spends 3 hours editing code, searching for similar problems and reading documentations but find nothing wrong and it's still not working.
-maybe it's django-crontab so I decide to just write a custom management command and call it through cron.
-still not working.
-calls function using what I'm telling cron to do.
-everything works.
-?????????
-adds logs to cron command (sorry for not making it earlier)
-mfw the code is not working because I imported 'patterns' in urls.py which has been deprecated since django 1.8 -
Was delaying learning a course for quite a long time (felt boring). The finally got the stuff by reading the documentations !
Tell me I am not the only one who thinks reading documentations is way better than taking course (in case of proper documentation ofcourse)2 -
You have a JavaScript application. You have to keep up with stupid devs that don't know TypeScript because you don't have the time to let them study it and they get demotivated when they can't do stuff so fine, you keep it JS. You use JSDoc to write the documentation. You miss using TypeScript so you start doing some @typedef's. Oh your linter gets it and starts behaving as a substitute of TypeScript. You get excited and write more and more @typedef's! ... until they get so complicated that you start documenting *that*...3
-
Me yesterday evening:
"Fuck java, fuck JVM, fuck everything about it, shit doesn't work for some reason, no runtime errors, no compiler errors, no syntax errors, nothing, *turns off computer*".
Me today morning(coffee = false), after comparing the documented example code provided by the API with one someone else made, I've noticed that the one provided by the API was messed up and couldn't work.
"Lemme change that one value in the properties...okay here we go"
Shit works out perfectly.
FUCK FALSELY DOCUMENTED CODE
FUCK DOCUMENTATIONS IN GENERAL2 -
TL;DR Dear boss, firstly, you always get someone to review anything important done by a fucking intern.
Secondly, you do not give access to your fucking client's production server to an intern.
Thirdly, you don't ask your fucking intern to test the intern's work that has not been reviewed by anyone directly on your client's fucking production server.
Last week, the boss and one of the lead devs (the only guy with some serious knowledge about systems and networking) decided to give me (an intern who barely has any work experience) the task of fixing or finding an alternate solution to allowing their support team access to their client machines. Currently they used a reverse SSH tunnel and an intermediary VH but for some reason, that was very unreliable in terms of availability. I suggested using OpenVPN and explained how it would work. Seemed to be a far better idea and they accepted. After several days of working through documentations and guides and everything, I figured out how OpenVPN works and managed to deploy a TEST server and successfully test remote access using two VMs. On seeing my tests, the boss told me that he wanted to test it on the client network. I agreed. Today he comes to me and he tells me to prepare testing for tomorrow and that the client technician is going to give me access to one of their boxes. And then he adds, "It's a working prod server. We'll see if we can make it work on that" and left. I gaped at him for a while and asked another dev guy in the room if what I heard was right. He confirmed. Turns out, the lead dev and the boss's son (who also works here) had had a huge argument since morning on the same issue and finally the dev guy had washed it off his hands and declared that if anything goes wrong from testing it on production, it's entirely the boss's own fault. That's when the boss stepped in and approached me. I ran back to his office and began to explain why prod servers don't top the list of things you can fuck around with. But he simply silenced me saying, "What can go wrong?" and added, "You shouldn't stay still. You should keep moving". Okay, like firstly what the fuck and secondly, what the fuck?.
Even though OpenVPN client is not the scariest thing to install, tomorrow's going to be fun.4 -
Today so far:
1. How to become a professional project manager in few months
2. From zero to pro in C++ with this course bundle
3. 2 Months into flutter and I regret nothing
Uni graduates: Remember when we had to bang our heads against the wall a million times to finally earn our degree!
Non uni graduates: Remember when you had to go through million documentations, write lots of code to sharpen your skills?
Ya both categories above can go fuck them selves, these days follow a tutorial or buy a 10 min videos to be the next big thing in any field ... -
Yes, I have to admit, sometimes Linux is a F*KING B*TCH.
I was supposed to fucking format a pc for a close friend of mine, cause he produces music and win 10 fucked his machine up with its broken updates.
Knowing the guy is a talent I promised that by 7PM the pc would be fixed.
Not really, I'm feeling the stupidest guy in this fucking earth, cause I've been here for 2 hours, fucking trying to extract an ISO image, and nothing on this fucking planet seems to work.
Tried the graphical archives, none open de ISO, tried 7z, it gives me an error, tried fuseiso, which is recommended in Arch Linux' documentations. Doesn't work. Tried mount - o my file.iso /mnt and it says /mnt isn't in the fstab file which makes me even angrier cause I always mount everything there without editing shit. So I installed 7-zip for windows in wine, it extracts until 90% and freezes. Now I'm trying hsuebrirbwkwpxjhw9shrbejejwke and my mouth is foaming and my ear is bleeding my brains out and I don't need you shit.
Fuck you, Fuck your goddamn ISO and Fuck this faggot ass spell checker, that changes Fuck to duck and assign to asset.
Fuck it, I ain't gonna format anyones pm anymore.18 -
Dash 3 for macOS is awesome!
It gives you instant offline access to 150+ API documentations.
http://www.kapeli.com/dash3 -
That moment when the CEO teaches you how "real programmers" spend 20% time in coding, and other 80% in writing company wikis, updating documentations and attending meetings.4
-
Have to say I enjoy being a minority, using a minor Linux distribution, with unpopular programming languages. The lack of documentations and tutorials means people have to think, they can't copy and paste whatever they saw, that is indeed a very high bar for human.7
-
Why is Google so bad in creating good documentations for their API ?
I send exactly what they specify and on some values I just get a 400. thanks for nothing3 -
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 -
I hate dark mode!
Stop defaulting to dark mode!
Stop making documentations into dark mode!
Browsers should stop defaulting to dark mode!
Ask me first if I want dark mode!
Don't hide the switch against dark mode!8 -
Python devs and data analysts....
Do you recommend using pycharm for working with jupyter notebooks? I surely had a bad time with it.
I have been using many jetbrains softwares , and am a fan of their docs search and autocompletion. But I don't think there is a full support for jupyter jn it, because sometimes my graphs made using matploit or seaborn just brakes.
And some libraries have a lot of functions taking parameters as " *args, **kwargs " , I don't know what that means but those function take a lot of "value" parameters i guess?(like this: plt.figure(figsize=[13,6], axis=False) )
Pycharm also don't seem to have access to list of those arguments...
Are you having such problems too? Have you found some better ide with autocompletions and support for jupyter? Do tell.
(Ps: i know jupyter can be run directly on a browser, but as i said "auto completions and documentations" )5 -
Me: I'll comment that later
Also me: Why tf isn't there any comment
No seriously, comments and documentations are really necessary. Today I've been debugging for hours, why a certain variable has a certain value. Age of code: 15+ years. No comments. No docs. 🙃5 -
Programming is a passion I’ve had since I was a kid and I saw my brother’s books on Basic and Pascal. YouTube didn’t exist back then... Stack Overflow didn’t exist and yahoo was my search engine after having to listen to the dial-up sounds. Once I found the right tools to learn on my own, after my first hello world program, I didn’t stop.
The fact that I’m still making time to write even a few lines of code every day, go through courses and dive into documentations makes me hope that one day I’ll be good enough!2 -
There should be an international standard for documentations of any development related framework, library, language etc. Its really annoying when you have to switch to something and the documentation style completely different.2
-
Acting as a volunteer project manager temporarily at the moment, it angers me that people don't read documentations before they ask questions.1
-
Programming has taught me
1. Importance of patience, friends and family and yeh StackOverflow too...
2. Importance of small contributions towards dev community.
3. How smaller things can make big changes.
4. Helping others and getting help if you get stuck.
5. Anyone can code, but very few can build robust solutions. Project not just coding but it needs preparation and planning too.
6. Importance of reading documentations, writing test cases, debugger programs.
7. You can learn things even if you have no idea about it. It just takes your interest. -
Junior Dev: "The man told me I have to use his framework but I don't know shit about it"
Me: "hmmm, since it's something he developed, you should ask him for some documentations or some examples"
Junior Dev: "I did!! That bastard gave me an example but I can't do anything with it. It's just executables, some config file and NO sources"
Me: "well, this sounds odd to me. You're telling me he just sent you executables and not a single source ? There is no .cs file in there?"
-- 2 minutes later --
Junior Dev: "now that I see ... The sources are there ... BUT the damn bastard put them into subfolders ... And there isn't a Solution file ... How could I even ..."
And THAT was the moment my brain collapsed into a black hole, obliterating me from the existence. Or at least that was what I wished for. -
So our Chief Test Engineer left the company because of overwhelming frustration and stress. We working on new stuffs so we test our partly done product with partly done test tool developed be another of our team. His successor started to drop most of the 3rd party tools and workflows and documentations to trash expect this one unfinished test software.
Now he wants that we add more features to this software so it can replace everything he trashed already: run tests, generate test reports, generate documentations and so on.
On top of that he organized a workshop to read all this software's source code together, understand how it's works so we can rewrite the whole software from scratch.
WHAT?!1 -
Am I the only one that find Google documentations shit, like they think you know everything and just give you the top part of the iceberg, but there are a lot of detail at the bottom!!!!!!!!!!!3
-
We used a javascript library before on our project. While reading the documentation, it states that you need to put the ajax response on an .addRow() function in json array.
That was what we did, but it keeps on throwing tons of errors. In the end, we visited our senior dev. Turns out, the function needs an array and not a json array.
I stopped reading documentations since then. And our senior dev stopped talking to us. Hahahajk -
They told me Xamarin Forms could create an app for many platforms
They didn't tell me that the Forms extensions for APIs would not work at all with the Android extensions, iOS extensions and I would need to reinstall them for each platform
They didn't tell me that at the end, I have to write individual code for each platform.
I was promised an all-in-one toolkit. I'm just writing code for Android and iOS apps, PLUS forms
I can't even find a reliable PDF generator for this. Documentations are outdated and don't work, either that, for it takes a million steps to generate a PDF file2 -
I spend more time reading bad written documentations with ugly examples that don't work (and anyways won't apply to other use cases) and reading about new concepts and new frameworks that should increase productivity, instead than actually write code and program.
Yes, it's increasing productivity, but it's not fun anymore -
Got the GitHub student developer pack in 10th grade (highschool)
I recently made an application for GitHub student developer pack which got accepted .
If you don't know what this pack is all about , let me tell you this pack gives you free access to various tools that world-class developers use. The pack currently contains 23 tools ranging from Data Science, Gaming, Virtual Reality, Augmented Reality, APIs, Integrated Development Environments, Version Control Systems, Cloud Hosting Platforms, Code tutorials, Bootcamps, integration platforms, payment platforms and lots more.
I thought my application wouldn't qualify because after reading the documentation , I thought that It was oriented more towards college and university students but nonetheless I applied and my application got accepted . Turns out all you need is a school -issued verifiable email address or proof of you current academic status (marksheets etc.)
After few minutes of the application I got the "pro" tag on my GitHub profile although I didn't receive any emails .
I tested it out and claimed the Canva Pro subscription for free after signing up with my GitHub account.
I definitely recommend , if you are currently enrolled in a degree or diploma granting course of study such as a high school, secondary school, college, university, homeschool, or similar educational institution
and have a verifiable school-issued email address or documents that prove your current student status, have a GitHub user account
and are at least 13 years old , PLEASE APPLY FOR THE PROGRAM .
Checkout the GitHub docs for more info..
Thanks !
My GitHub GitHub Username :
satvikDesktop
PS. I would have posted links to some sites and documentations for further reading but I can't post url's in a rant yet :(5 -
Spring boot does very much automagically.... but to find every possible configuration is hard....
I found out that it has an automatic config for Scheme Server... but how the fuck to configure it 😑
And do I still need avro made domain objects 🤔 it's hard to fight through all these documentations and versions of spring. 😖 -
Flight Gear.
I had one heck of a time during my pre teen days flying airplanes and going to famous cities around the world in this cool flight simulator game. On a related memory, I think it was in 2008 or something, when Yahoo messenger was the popular thing, I sent a message to one of the main developer about how I can build planes and stuffs for the game. He responded and said something about C++ and some documentations.
This was way before I knew anything about programming. I found myself frustrated about not knowing or understanding any of the guides.
Then puberty happened. -
IT teachers here at my school giving us 20 different and completely unsuitable for Access databases businesses, as subjects for indeed Access databases. And then be like "Create documentations for that"
And they actually mean by that is
So I clicked here then there and then I selected and pressed the C symbol key while holding the Control key on the keyboard input device connected on my computer, which happens to be plugged into the wall outlet..
As a full-stack developer this is just so cringy I'm speechless.. -
Fuck google and their Android-API documentations and guides. I just want a controllable service, that plays audio in the background, not a second Poweramp with android car support2
-
I am really tired and frustrated.
Where should I even start?
I have created a TeX element with "/Math".
Then I have tried to type in a sum sign which works with "\\sum". BUT it won't let me display numbers below and above the sign. I tried to fix this by typing in "\\sum{someNum}{some\_other\_num}". It didn't work. I tried "\\qquad \\displaystyle\\sum\_{i=1}\^n". It still doesn't work. I tried "\\underset{}{}". It didn't work.
I tried to import the ams package. It didn't work.
I tried to read the official notion documentations. They didn't exist.
I tried some of the above KaTeX commands, because I saw that notion is using a KaTeX parser. "\\qquad" worked whereas "\\;, \\>" etc. didn't work.
"\\newline" and "\\\\" don't work.
When you have your formula written, it displays the latex commands and the results together when you don't edit the TeX/Math element anymore.
I would be very thankful for helpful answers.8 -
Google Analytics has such shit documentations. They switched from some analytics.js to gtag.js, but didn't update everything in the docs, so I have to guess and find how to do things the new way. Also all the issues on StackOverflow are by marketing "specialists" who don't even understand JavaScript. And debugging any of this is near useless. You just send data into a magical data layer and hope Google does what you want. It's a fucking black-box and I've no idea why nothing works. FUCKING GOD DAMN PIECE OF SHIT, WOOOORK!
-
I use Google, stackoverflow, tech documentations to unstuck myself and I'm not afraid to admit it coz ham1
-
Being a developer for 6+ years in many different stacks, and moving up to a kinda lead level position, has made me feel like I’m not working as much as I was doing before.
Yeah I do code reviews, meetings, tech documentations and peer coding sessions, but still doesn’t give me the feel like I did the work I was supposed to do.
Anyone ever felt this and any tips to overcome?3 -
Grammarly Beta is now available works Google Docs.
Looks like I won't miss any 'a'/'an' or 'the' anymore in my software documentations8 -
If the documentation does not make any sense, I always try to look up some articles or tutorials. But I found out that especially on the Medium platform, so many people copied word to word from the official documentations, I was like what is wrong with this mf's.2
-
!rant
Anyone know a template for documentations beside gitbook?
Not specifically for a language, just a framework or a template where we can add text, images, code, etc .
I am not talking about markdown here.
Btw, is there a free template just like https://codelabs.developers.google.com/...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 -
In reply to this:
https://devrant.com/rants/260590/...
As a senior dev for over 13 years, I will break you point by point in the most realistic way, so you don't get in troubles for following internet boring paternal advices.
1) False. Being go-ahead, pro active and prone to learn is a good thing in most places.
This doesn't mean being an entitled asshole, but standing for yourself (don't get put down and used to do shit for others, or it will become the routine) and show good learning and exploration skills will definitely put you under a good light.
2)False. 2 things to check:
a) if the guy over you is an entitled asshole who thinkg you're going to steal his job and will try to sabotage you or not answer acting annoyed, or if it's a cool guy.
Choose wisely your questions and put them all togheter. Don't be that guy that fires questions in crumbles, one every 2 minutes.
Put them togheter and try to work out the obvious and what can be done through google or chatgpt by yourself. Then collect the hard ones for the experienced guy and ask them all at once. He's been put over you to help you.
3) Idiotic. NO.
Working code = good code. It's always been like this.
If you follow this idiotic advice you will annoy everyone.
The thing about renaming variables and crap it's called a standard. Most company will have a document with one if there is a need to follow it.
What remains are common programming conventions that everyone mostly follows.
Else you'll end up getting crazy at all the rules and small conventions and will start to do messy hot spaghetti code filled with syntactic sugar that no one likes, included yourself.
4)LMAO.
This mostly never happens (seniors send to juniors) in real life.
But it happens on the other side (junior code gets reviewed).
He must either be a crap programmer or stopped learning years ago(?)
5) This is absolutely true.
Programming is not a forgiving job if you're not honest.
Covering up mess in programming is mostly impossible, expecially when git and all that stuff with your name on it came out.
Be honest, admit your faults, ask if not sure.
Code is code, if it's wrong it won't work magically and sooner or later it will fire back.
6)Somewhat true, but it all depends on the deadline you're given and the complexity of the logic to be implemented.
If very complex you have to divide an conquer (usually)
7)LMAO, this one might be true for multi billionaire companies with thousand of employees.
Normal companies rarely do that because it's a waste of time. They pass knowledge by word or with concise documentation that later gets explained by seniors or TL's to the devs.
Try following this and as a junior:
1) you will have written shit docs and wasted time
2) you will come up to the devs at the deadline with half of the code done and them saying wtf who told you to do that
8) See? What an oxymoron ahahah
Look at point 3 of this guy than re-read this.
This alone should prove you that I'm right for everything else.
9) Half true.
Watch your ass. You need to understand what you're going to put yourself into.
If it's some unknown deep sea shit, with no documentations whatsoever you will end up with a sore ass and pulling your hair finding crumbles of code that make that unknown thing work.
Believe me and not him.
I have been there. To say one, I've been doing some high level project for using powerful RFID reading antennas for doing large warehouse inventory with high speed (instead of counting manually or scanning pieces, the put rfid tags inside the boxes and pass a scanner between shelves, reading all the inventory).
I had to deal with all the RFID protocol, the math behind radio waves (yes, knowing it will let you configure them more efficently and avoid conflicts), know a whole new SDK from them I've never used again (useless knowledge = time wasted and no resume worthy material for your next job) and so on.
It was a grueling, hair pulling, horrible experience that brought me nothing in return execpt the skill of accepting and embracing the pain of such experiences.
And I can go on with other stories. Horror Stories.
If it's something that is doable but it's complex, hard or just interesting, go for it. Expecially if the tech involved is something marketable.
10) Yes, and you can't stop learning, expecially now that AI will start to cover more and more of our work.4 -
Me and this friend of mine were usually average in college subjects. We were not really bad at them, we just never got any exceptional marks in those subjects.
So when our 4th sem result came, a third friend of us got really good marks in some subject , like in 90s, and we again had marks around 70s.
At that time we both knew that we know that subject way more than this topper guy in terms of knowledge, but he just crammed everything about that subject word to word and got the better marks.
We thus believed that marks doesn't matter, its the knowledge and we both know its stupid to cram useless things which could easily be referred from documentations or internet when required.
But last sem, something different happens. looks like mah boy was a little envious on the inside, he scored a whopping 88%, just near to that topper friend of ours . i was happy watching his happiness , and he was saying that "dude this sem, i will even try to beat that guy in marks."
Even though none of them are class toppers, but they are somehow running in the race to be one. I on the other hand is still firm on the belief of not cramming stupid shit just to get a status of some 'topper'.
even though cramming subject knowledge is not a total waste, i still believe we should only understand what we need to understand, like learning the moral from a war story, not cramming the actual war dates.
Some might find this quality of mine to be the reason of me being 'average', but i feel totally fine with it. I have trained myself to be able to lookup for a particular resource online faster than they are able to lookup for that resource crammed in their brain memory, and i wonder if i should feel guilty about it. Yet the society will always see me as an 'average' guy and them as a 'winner' -
Working on some documentations on MS word and I'm pressing ctrl+space for auto complete!!🤣🤣🤣 Not only that ctrl+click for multiple cursor!!! 😂😂😂😂😂2
-
When the documentation writes a function with random capital letter by a new word like 'setcolorOfThis()'. Took 4 guys until we solved the problem, all letters should be small. Stupid documentations1
-
Relatively often the OpenLDAP server (slapd) behaves a bit strange.
While it is little bit slow (I didn't do a benchmark but Active Directory seemed to be a bit faster but has other quirks is Windows only) with a small amount of users it's fine. slapd is the reference implementation of the LDAP protocol and I didn't expect it to be much better.
Some years ago slapd migrated to a different configuration style - instead of a configuration file and a required restart after every change made, it now uses an additional database for "live" configuration which also allows the deployment of multiple servers with the same configuration (I guess this is nice for larger setups). Many documentations online do not reflect the new configuration and so using the new configuration style requires some knowledge of LDAP itself.
It is possible to revert to the old file based method but the possibility might be removed by any future version - and restarts may take a little bit longer. So I guess, don't do that?
To access the configuration over the network (only using the command line on the server to edit the configuration is sometimes a bit... annoying) an additional internal user has to be created in the configuration database (while working on the local machine as root you are authenticated over a unix domain socket). I mean, I had to creat an administration user during the installation of the service but apparently this only for the main database...
The password in the configuration can be hashed as usual - but strangely it does only accept hashes of some passwords (a hashed version of "123456" is accepted but not hashes of different password, I mean what the...?) so I have to use a single plaintext password... (secure password hashing works for normal user and normal admin accounts).
But even worse are the default logging options: By default (atleast on Debian) the log level is set to DEBUG. Additionally if slapd detects optimization opportunities it writes them to the logs - at least once per connection, if not per query. Together with an application that did alot of connections and queries (this was not intendet and got fixed later) THIS RESULTED IN 32 GB LOG FILES IN ≤ 24 HOURS! - enough to fill up the disk and to crash other services (lessons learned: add more monitoring, monitoring, and monitoring and /var/log should be an extra partition). I mean logging optimization hints is certainly nice - it runs faster now (again, I did not do any benchmarks) - but ther verbosity was way too high.
The worst parts are the error messages: When entering a query string with a syntax errors, slapd returns the error code 80 without any additional text - the documentation reveals SO MUCH BETTER meaning: "other error", THIS IS SO HELPFULL... In the end I was able to find the reason why the input was rejected but in my experience the most error messages are little bit more precise.2 -
Why are big software documentations versioned by url rather than adding the most current update to relevant sections and signifying it as such?
1) only select parts of the software is updated in between major version updates. Why duplicate the entire docs for only sparingly updating those parts?
2) references hold versioned urls that could go out of date. I imagine it takes some effort to have a banner on each page indicating whether this is the most up-to-date version of the software
3) deprecated documentation is redundant since it's no longer maintained. Why does it continue to exist? Not everyone has upgraded, you say. That, and I guess, it costs the maintainers nothing to have an idle folder 6 major versions behind the most recent
I already have a folder for my v1 but I'm considering pulling them into a permalink. What challenges or disadvantages are there to doing so?6 -
Nothing better than Rust and LALRPOP. I've been trying to play with Bison and C++ for the whole quarantine and nothing would compile. I just sat for two days with Rust and LALRPOP and I was able to make a small interpreter that can make new variables, calculate simple expressions and print stuff. Like this:
var = 5 + 3;
print var;
var = 2 * var + 4;
var2 = 3 * var + 3 * (var + 4);
print var2 * var;
And all this in just two days. I have no Rust experience except for toying with it on an online playground. I have no LALRPOP nor parsing experience. Two days.
Now, it's not like I wouldn't be able to do this in C++ too if somebody told me how to. But nobody has. And the documentation online is gruesome. None of the bison example I found online could compile. This is why documentation matters people! Honestly, if there's one reason I think old projects die, it's because they ether don't update themselves OR they don't update their documentations. Look at the US government now, looking for COBOL programmers.4 -
Guys I need to deploy a very simple authentication API service.
You register with a username (actually an ID with a determined format), a password and uuid. You login with your username and password and if credentials are correct you get back the uuid as a response (JSON or whatever the fuck).
If you forget your password, you can use your uuid (which is confidential, very long string) in some POST request to set a new password. If you forget your username, you use the uuid again in a GET request to get back your username.
I've been looking at a bunch of solutions online and I don't think they suit my purpose exactly and all require emails (Like Firebase, AUth0, etc.) So, let me get this straight: NO FUCKING EMAILS INVOLVED PLEASE.
The above are the EXACT requirements I need for my work (for a good cause too). I fucking hate 0-requirement exploratory research tasks and I'm plagued with those. Those requirements are the only way it should work. So again, NO EMAILS INVOLVED PLEASE.
Also, please note that I have never developed an API in my life. I feel like StackOverflow will be assholes about this so I am asking this here.
I know it is very easy to do and there are probably dozens of ways to do this. I just do not know how, documentations are vague and overwhelming (or I'm just a little stupid lately). Another thing is that I am not sure of how can I do this in the most secure way. Bonus if this can be dockerized.
I know I sound a little rude,so I am sorry. It is just my frustration and depressing times I am going through that's preventing from thinking straight.6 -
My team works as a growth team. So, I have to start with different documentations from different teams each time I start a project.
The thing is documentation is badly written and you have to dig a lot to find a small thing.
At the same time, culture of the company urges us to go deep before contacting another team.
Each team's documentation is different and some people force on reading the documentation before contacting them. Growing technically has become a lot more challenging me and honestly I don't want to do this anymore. -
reading books, documentations and specifications within minutes and remember anything in it, so i can directly start on getting to work and know which solution might be the best without spending days in specs and doc. :)
-
I'm the one who create the documentations for our new task (Examine an existing and update it later on) because I'm the only who's currently doesn't have a task yet and my co-dev are currently fixing other project.
So I list some dependencies and information that will help us to understand this project, I also provide good sources which they can read, and also create a sample program which they can get from our repo and I also document it ( from config to crud)
So now they're (both my seniors) in same task with me but before they start I already give my documentations to them , and guest what, one of my senior appreciate my job and the other one who's saying he is the "team leader" and he doesn't even bother to read my documentations, and he prioritize other projects which he does not involve , and now he's creating his own sample program without reading any sources and copy pasting of some code from our project source code. -
I took a career transition last year and I'm starting to question my decision. I'm stuck.
I've only learned to hack shit together in my past jobs (except one freelance project where I pretty much learned most of what I now properly know), exposing me to bad practices. To make it worse, I lack fundamentals and basics so can't even write JavaScript beyond for loops without documentations.
Lately I've been pushed to take charge in structuring a project from scratch. I failed at understanding what exactly Webpack does mainly because it required knowledge of web modules which I still find elusive. I make time to learn basics in the evening or weekends but most of the time I'm taking home the internship work project that I, again, just need to hack shit together, depleting my energy by the end of day.
Now I'm at the stage where I need money, for which I'm thinking of applying for waitressing or entry-level marketing jobs. I'm shit scared that I'll never break into the industry and will just end up living day by day feeling unfulfilled.
I'm so tired of trying.2 -
Can traefik's documentation and configuration be any more confusing and retarded? I hate this thing. Any good alternatives?1
-
When you do a microproject on some framework, make sure you know how it works, as in, know what you've written rather than blindly copying from tutorials, stackoverflow or documentations.
-
As a person trying to learn C, I am sick and tired of the lack of visuals for C functions. As a person who best learns by visualization, I find it rather difficult to learn the difference between functions such as malloc, calloc and memset. All I can find on Google is the same written documentations.