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
-
Boss assigned me a task on Google Docs:
Boss: "Please remove this line"
Me: "What!? You're already there! How hard is it to fucking select the fucking sentence with your fucking touchpad and press the fucking delete key on your fucking keyboard!? Why assign me with such a fucking waste of time and fucking trivial task!?"14 -
Facebook employees need to work on their sense of humor -.-
Found it in React Native docs (https://facebook.github.io/react-na...)
7 -
--- Save some time with Google's .new-Domains ---
A few days ago, Google announced their new '.new' domains.
By using them you can save plenty of time when creating new Docs, Sheets, Slides, Sites or Forms.
So instead of going to Google Drive and creating the document there, users can just input the corresponding URL into the browser!
Here are a few examples:
> 'doc.new' or 'docs.new' or 'documents.new' to create a new Google Docs document (https://doc.new/)
> 'sheet.new' or 'sheets.new' or 'spreadsheet.new' to create a new Google Spreadsheets document (https://sheet.new/)
> 'site.new' or 'sites.new' or 'website.new' to create a new Google Sites website (https://site.new/)
> 'slide.new' or 'slides.new' or 'deck.new' or 'presentation.new' to create a new Google Slides document (https://slide.new/)
> 'form.new' or 'forms.new' to create a new Google Forms form (https://form.new/)
This is also useful for creating special bookmarks in the browser!
34 -
I guess Elon Musk is too focused on colonizing mars to the point that he forgot to improve PayPal's API docs.16
-
Susan, where are the fucking API docs?
Harold?
Jimmy?
There ar no FUCKING documentations for all our APIs????14 -
Docs: If you get a 500 error [...] you may need to run chmod -R 777 storage[...]
I: wait *reads again*
Doc:s chmod -R 777
I: 😲
Docs: 777
I: rm -rf ./5 -
Programming tip of the day:
Several hours of trial and error can save you many minutes of reading the docs.9 -
Summary of my last hour (it's sunday night):
-Procrastinated 1 hour
-finally stopped procrastinating
-opended google docs
…
4 -
"Don't bother reading the docs, they're just technical crap"
Well guess who knows how the framework we're using works 🤔1 -
PSA: Read your mails before sending them, because some shitty versions of autocorrect like to translate "docs" into "dicks".5
-
Them: Migrating their repositories to gitlab/bitbucket.
My classmates: using Google docs as Version Control.5 -
Researching theme shit with UWP. They had some interesting contrast suggestions in their docs.
Actual image from Microsoft's actual website.
5 -
Have been coding all day and now writing the docs. I keep pressing ctrl+space and tab and expecting auto complete to work. So annoying5
-
My first research publication! 😀
http://serialsjournals.com/serialjo...
Also at:
http://kaustubh.tech/docs/...12 -
Why don't devs read the fucking docs?
Time and time again I find my coworkers inventing new ways of doing stuff that could easily be done with existing features.
Today I saw this on a code review (functions are from lodash):
head(filter(...))
That's what fucking `find` does, you dense motherfucker!
This is just a tiny example. I've seen so much of this shit. Sometimes it's almost art how they find ways to solve problems without actually reading the docs.6 -
I think my days as a dev are over
shit fuck!!!!
All i know is writing code, schematics, systems recommendations
Was given a tender doc for a project
the doc was in 2 parts "Technical" & "Financial"
I HAVE NEVER DONE A TENDER BEFORE and little did i know a shit load of documents are required
MY BOSS GOT FURIUS SINCE I DIDNT COMPILE ALL DOCS and 1 required doc was expired tried to get it renewed and renewal will take 3 week or 1 month and deadline was in 2 hours time
FUCK!!!!
F U C K M E ! ! ! ! !15 -
When you gotta refer docs, write code and Test mulitplayer........you need the squad!
Working on implementig mulitplayer for my game!
7 -
No Microsoft Word, I'm pretty fucking sure it's spelled Git and not Gilt.
#Preparing Code Review Docs5 -
So I was browsing through some Redis docs and I find this. HOW THE HELL CAN YOU NOT KNOW HOW TO SPELL KOREA!!!!
6 -
I give MS a lot of cr@p for terrible API documentation, but even Google's API docs are pretty terrible to read through.
Seriously, guys... Your docs shouldn't read like an endless page of search results.4 -
ceo: we need new docs, kiki should make them
tens of team members: lemme explain docs to kiki
ceo: don’t you fucking dare, let kiki execute their unique thought process
☺️14 -
I hate it when people put time into making their docs look nice but none into making them actually helpful!3
-
Has anyone ever taken on a project where you dont know what you are getting yourself into, and then start it and going down the rabbit hole of docs and then at some point ask yourself "what the f u c k am i doing?"8
-
At work we have a lawyer lady who we pay a LOT of money and she suppose to handle our tech related legal stuff. We ask her to look at some stuff we shared with her via shared google docs. After being visibly uncomfortable for a while she called her tech guy at her firm and asked to get Google Docs installed.3
-
If you ever get an idea for an OpenCV project: shoot yourself in the foot, drink some bleach, do whatever it takes to get it out of your head, because it will all be less painful than the python docs for cv2.3
-
Was so confused what the new walrus operator did. Why don't the docs give a simple comparison example like this?
5 -
My Friends: Celebrating XMas together
My Family: Celebrating XMas together
Me: Celebrating XMas by reading MongoDB docs 😏😏
There is no better way to celebrate xmas3 -
Email chains, screenshots shared in google docs, two comments per 1k lines of code, and sticky notes are sufficient documentation, right? RIGHT?2
-
TIL Nginx supports js out of the box. You don’t need nodejs to write servers in js. You can install Nginx and make it execute js code to generate pages. It even supports TypeScript!
https://nginx.org/en/docs/njs/
https://nginx.org/en/docs/...12 -
Had to integrate legacy code into the new framework.
Me: Where does the virtual sensor come from?
Colleague: It's in the docs.
Me: That step is not in the docs.
Colleague: It is, look into the file $FILE.
Me: Yeah, it's empty :D
Colleague: Nope, it's not.
Me: See, empty (pointing to laptop screen)
Colleague: Why is it empty? (keyboard typing...) Damnit, too many git remotes in my repo :D -
I can't believe this is part of an official documentation (wordpress).
Tldr, they want to tell you how to remove all characters in the end of a file lol
3 -
** PSA to all programming language and tool maintainers **
Please for the love of god have a dedicated examples section on your website where people can quickly evaluate what the thing even looks like
So often the next best thing is going to the docs where they tell you that the turboblub option should be set to 12 in these specific usecases whEN I DON'T eVEN KNoW WHETHER THIS IS A PROGRAMMING LANGUAGE OR A LAWN MOWER3 -
What the fuck happened to laravel docs, what fuckwad thought the only docs across the entire internet that are properly readable, need its shit fucked up and made into borderless, bold fontweight, shit font dogshit.
12 -
So I was writing docs for my project the hard way. Manually. Every time I added something new, I had to find the right place for it to be alphabetically in the reference. And god forbid I want to have the same information in two pages: I would need to copy/ paste and pray that I not forget to update the information EVERYWHERE.
I didn't feel like installing and learning some new markdown generating bullshit so I just made my own system. It's very simple and intuitive and I love it.
I made sure it can cover two use case: reading partial documents from the disk, and rendering in-memory objects to markdown too (like rendering a collection of tuples into a table)
I didn't care much for templating, so there's no templating capability.
2 -
After trying polymer for a week, I can officially say that it is the most confusing framework ever.
They need to learn how to properly document their code.
Stack overflow doesn't help because the dipshit who asked the question ALWAYS "misspelled" a variable.1 -
Why do most docs have grey text color over a white background! It's just incredibly difficult to focus on. And my brain is like a potato to begin with.6
-
I love Flutter. So simple. Such good docs. Not totally shit multiplatform. Flutter is my new favorite framework. Good job Google5
-
Discover that stackoverflow has documentation. Now they will start to yell "Check the fucking docs!!!"
-
I started using Google Docs over the weekend working on my thesis paper for my CS degree. I've come to the conclusion that it's a suitable replacement for MS Office and my need for Microsoft's ecosystem. Don't know why I kept paying it for so long.7
-
That moment when you were finally able to make a plugin after 36 hours of frustration for a software with absolute shit docs and not many resources thanks partly to a small article (written in german which you had to translate) that you found lurking in the corner of web. 😌2
-
One thing I hate about documentation and tutorials is they always seem to use the simplest examples they can think of. They show you how easy it is, but if you want to use it in the real world start digging further.1
-
That moment when you try to use your IDE keybindings on Google Docs :|:|:|:|:|:|:|:|:|:|:|:|:|:|:|:|:|:|:|1
-
Recently I had to work on a project using PrestaShop. Naturally I looked up the "docs" and found the part where they recommend to write documentation.
Fine until you realize they don't and the documentation website gives generic useless informations...
-
AWS write awful docs. The .Net SQS example code has spelling mistakes, bits missing and doesn't work.
Also would be helpful if it highlighted that the .Net Core implementation is fundamentally different.
Jerks.5 -
So I just found an old branch, from an ex co-worker, with a whole bunch of unmerged docs. This effectively cuts my workload for today in half.
Today I'm going home early fuck yeesss
Also I will be sending that guy some well deserved couple of beers1 -
DevRant-API-Docs Site Update:
QA is in the works. Will try to keep it as simple as possible!
The "all questions" page front end is done. Now there's only the "new question" page and the "view question" page.3 -
Oh Lordy, time to yank out those old RPI's and throw vsCode on them!
https://code.visualstudio.com/docs/...
5 -
Few weeks ago: Please write the system design docs for feature X of the new project Y. We need it in two weeks.
Few days later: Stop working on the docs, the customer hasn't yet bought that feature.
Few days later: We found that we included that feature in the main contract already. We need the docs in two days.
Today (docs delivered a month ago): There was a misinterpretation of the requirements and the contract, the customer hasn't bought the feature with the main contract, it has to be sold additionally. You didn't do anything 'til now, did you?
It would be really nice, if sales could finally decide what the customer bought and then tell me about the requirements that are already covered in the docs anyway. But I fear it could end in asking the customer 🤪🔫2 -
I love Google Docs.
I hate their white-only style.
I love writing at night...
So I made myself a userscript to help my eyes when working late. Unfortunately they have css classes' names constantly changing (dynamically generated) with each update of the source code and I was too lazy to go full javascript on them because it'd make a lot of "getElement..." stuff or even jQuery only to change the theme.
It wasn't like full broken page, no... only some elements were broken, but in places it'd burn your eye out in 2am when the theme is almost black.
I felt like I have to do something, because I don't want to lose the Docs at night, but writing on their email list would be like talking to the wall. Then they updated again, some elements changed again and I was like... man, fuck you!
div#doclist > div > div > div > div > div > div > div > div+div
div#doclist > div > div > div > div > div > div > div > div > div > div+div
It works, if you are interested: https://github.com/KeyWeeUsr/...18 -
That moment during your internship when you work on a project using a framework you're not familiar with, with no doc, and absolutely no comments, and you find a file with 1.3k lines of code without the ability to contact the previous dev
4 -
code code and code. There's no better way to learn other than practicing the material learned from docs.1
-
I’ve been a solo frontend developer for a couple of weeks now with critical enormous features and some bugs to get out the door by the end of next week.
On top of that, I got a backend bug to fix which is fine since I know the stack. The SQL that’s causing a bug is an obvious fix but as a FE dev I have no damn idea about DB structure.
I decide to setup local DB to see it for myself. So as a reasonable developer I look for docs to set it up since it sounds like quite a process after confirming with colleagues.
ANNNND... SURPRISE, the docs ARE NON EXISTENT unless you wanna call an outdated diagram a sufficient doc. Just so you understand the pain, we have 9 micro services, a weird db structure and only 5% is documented.
I requested help from my colleagues, but their answers were similar to docs with a follow up of “maybe you can document it after you set this up”. Barely stopped myself from asking “do I look like I have time for this crap? Why don’t you document it SINCE YOUR SETUP IS READY TO GO?”
So I’ve been at it for a couple of hours and I gave up. Will go back to frontend development since still a ton of shit to do anyway. Tomorrow I will attempt this again.3 -
DevRant-API-Docs Site Update:
The overall is now done!
I still have to do the actual docs content but the playground, the Q&A and the links page are pretty done now and only require some little changes.
Here's the link:
https://devrant-docs.github.io/
Have fun!8 -
LuaDocs V1.0 available now!
More updates coming soon!
Live site: https://cozyplanes.github.io/LuaDoc...
Repo: https://github.com/cozyplanes/...1 -
FUCKING FUCK I CANT FUCKING HANDLE THIS
WHY THE GODDAMN ***FUCK*** DOES CINNAMON NOT HAVE DOCS FOR ITS DESKLETS
THE ONLY TUTORIAL RELATED TO IT IS FROM FUCKING 2014
THERES LITERALLY ZERO DOCUMENTATION ANYWHERE ON THE INTERNET
HOW ARE PEOPLE MAKING DESKLETS AND APPLETS WITHOUT DOCS4 -
What is the fucking point of creating an amazing device with amazing software, which has a very nice API BUT USELESS FUCKING DOCS.
The thing has features that are only visible in their software, it is mentioned nowhere in the api docs and I have no fucking idea how to access those important features. Fuck you1 -
Wrote some docs in a simple format. Really KISS here with the docs and the tech they describe. How's the readability?
https://algorythm-dylan.github.io/q...3 -
Why do all the cool things have terrible documentation?
I'm looking at you Gnuradio and OpenCV!
Doxygen doesn't count if you don't actually write doc comments!!3 -
Android Documentation.
I don't get any of them.
They don't make any sense.
https://github.com/cozyplanes/...3 -
Google OAuth docs is such a pain to read... I have implemented OAuth multiple times and understand the flow. Its never been a problem, but man, their docs is such a pain to read.
Their Java client library is also painful. Its needlessly complex that I just ended up implement good old HTTP rest to handle it.5 -
You know that moment, when you look for something on wikipedia, and after few hiperlinks you are reading about influence of penguins on Mars' day length or othen nonsense?
Just happened to me like 4th time when reading Django documentation. It is so well written and easy to understand, that I just click and click and want to go deeper, and then realise I have to read what I need, because I never ever got to it in the first place.
Gotta love the people who make such docs. I never could, and prbly will.1 -
Love the docs that provide lots of segment examples everywhere, but no full examples. No source code. Very helpful2
-
Love writing comments, hate writing documentation.
Ugh, I know it is needed but just don't care about it as much as the code/comments which is a more direct 'here is what this does' approach. Writing idiot proof documentation sucks. Any little change? Have to remember to update the docs. Yeah, not happy.1 -
You can create programms for google docs now, with a new docs api. Might save some time.
https://developers.google.com/docs/...
3 -
Build this as a monolith, microservices are to complicated..
Said no and did the docs first, to make it look easy. Problem solved ;) -
DevRant-API-Docs Site Update:
Finished Auth System.
The Authentication System should be ready now. You can login/register and create questions/answers!
So the Q&A Section is fully functional now!
Please note that there may be bugs!
If you find one, please report it here:
https://github.com/DevRant-Docs/...
Have fun!7 -
When your site was developed by someone with a programming degree from the 70s and has no API docs....wheeeeee1
-
Here's the intro of the documentation I'm reading in my new job:
...we have four sections. First 3 section will use LBC and the last 2 section will use HBC
🤔 -
I like Scala, but the docs suck.
The FAQ literally uses StackOverflow links as answers.
Not as references, where they write the complete answer and provide the link for reference or credits.
They actually just throw in the links.
1 -
I really hate people that don't document well their 'inventions'.
Let's take for example kotlinx.serialization library. It's a self-obvious fact that there are at least two things that will make anyone suffer: generics and polymorphism. So, they must be on the front page. Solved. With a recipe. Ready to use.
And what do we have? One mention somewhere in docs and an amazing test that 'explains' 'everything':
https://github.com/Kotlin/...
'What we got here is a failure to communicate.' (c)8 -
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 -
I love how all the shorthands for events are deprecated, but JQuery docs still haven't been updated.9
-
onEnlightControllerActionPostDispatchBackendPluginManager
Who needs docs if you've got such speaking method names.2 -
I always write a Google Doc before I start developing a feature to help me think what and how should I implement it and so I can share it with the team.
It is possibly the most frustrating process of the whole development cycle because Word and Google Docs still manage to make it a fuckin ordeal to insert a simple image without bombing the whole text to hell. How is it that after almost 30 years of history it is still shit to write a document?8 -
Why on earth I am doing docs and sending them to the whole team, if they keep asking me how to do X and why is Y not working
YOU WILL KNOW IF YOU READ THE DOCS
GAAAAAAA2 -
stupid react fucks, they upgraded webpack to 5 which breaks being able to access process.env
good thing you can't access the webpack config to fix it!
essentially this "wise decision" by the team makes this entire docs page WRONG: https://create-react-app.dev/docs/...21 -
DevRant-API-Docs Site Update:
Started with the back-end for the Q&A yesterday.
You can see it here:
https://github.com/devRant-Docs/... -
Giving time to understand concepts to the core, rather than reading the docs, getting a surface level overview and coding.
-
1.) Read the docs on the website
2.) Curse the Devs for bad docs
3.) Go to YouTube and pray that I find a food tutorial WITH AUDIO!
(jk,sometimes some docs r very neat and clean) -
I don't like things like "programming is copy&paste"
But if you think about it... Actually it is: when you don't know how to use a function or how to write a new language you read the docs, copying and using what they say 🤔
Stack Overflow? It's a doc full of examples 😁6 -
So, I've been trying to learn assembly. However, I can't find any assembly docs online, so I can't really do anything. I tried NASM and FASM but I just can't understand assembly. Do y'all know any decent way to learn assembly? (My dad said it's better to do it on my pi or should I do it on my desktop?)8
-
Google documentation sucks!
Lack of practical examples. They show us very simple example like clicking on button and then straight away redirect to API docs.
Wait, let me at least understand how things fit in together.
Me: Hey google where is step by step guide, at least for setup?
Google: We don't do that here!5 -
Read the documentation!
...(follow docs)
Why did you do it that way?! The documentation is outdated!!
...(doesn't read docs makes best guess)
Why didn't you follow the documentation??!!
Sigh. -
is there a google docs for ides? like, real time editing where you can collab while you are?
i think that would be cool.
anyone else?5 -
I was just clicking trough oracle's docs, on a page which had to do with manifest&sealing (kotlin/java)
-
Studying for college exam
- 2min/sitting
Coding/reading Docs/Book of interest.... after 12 hours
- " OMD ... I completely forgot, i own a mobile"1 -
Best: Public docs, especially quick start guides... That actually work.
Worst: my team's. It's basically non-existent... I'm the only one that writes docs and design diagrams and well that's mostly for myself to remember/understand stuff and use when ppl ask....
My first response is usually like: "Here RTFM... (Now go away because I have other things to do)" -
Obligatory repost of @Skayo 's and @frogstair 's revamped API docs.
Thanks to our lords and saviours.
https://devrant.com/collabs/...2 -
Who the hell is writing google documentation, If I see you, I want to fuck your stupid ass mofo... These docs are useless as fuck. I think it's the same person or maybe there are many copies of this washed head stupid ass writing the same kind of shitty docs all over the place.
-
I was playing with AWS and came across Rekognition! Although the docs are poor, the service is just amazing. Mind blown.
-
That moment where you find how to do it in the docs
But you had passed that section 3-4 6 times
But you had already formulated your own fix
And you have to redo that code block -
Does anyone know where are the *official* devrant api docs? Tried web searching but could not find them.10
-
Hey documentation providers! Some of us don't want to have to go to slow ass websites to look up everything about your code, system, library, api, etc. It also really sucks when trying to work on those systems without an internet connection. So, please provide offline documentation.
A special thank you to Python for providing help files with Python itself. This has been a life saver when working offline.
Also a special fuck you to Bethesda for not providing an offline version of the Creation Kit wiki. Everything else you do is nice, but please provide offline docs.11 -
➡️ Started searching and reading the MailChimp docs.
⬅️ Ended reading the letsencrypt docs about CAA-Records. 🙈 -
I've been trying to build docs that worked before for my little project for a fucking week. A problem with dependency, because it couldn't just install for whatever magical reason, although in another repo the dep was installed just perfectly.
A few seconds ago it built. Again, magically.1 -
Using Microsoft's docs for Azure is about as fun as Spreading Your Ass Cheeks for an incoming elephant dick.3
-
Is there anyone who has ever used frappe/erpnext?
It drives me nuts, as much as I like the framework doing any thing that needs some basic scripting is a pain!
I MEAN, COME ON MAN, WHY ARE DOCS SO HARD TO COME BY? WHY DOES YOUR "CUSTOM SCRIPT" EDITOR LACK BAISIC LINE NUMBERS? WHY ARE YOUR ERROR MESSAGES TELLING ME EVERYTHING BUT THE LINE THE ERROR'S ON, SO I'LL BE HOPEFULL THE ERROR IS IN THE DEV CONSOLE? WHY NOT USE MONACO, SOMETHING, ANYTHING THAT WILL SHOW SYNTAX ERRORS? I'VE WAISTED HOURS ON LITTLE AUTOMATION SCRIPTS!!!! WHY WHY WHY WHY????1 -
When the docs are on a different Pompey Pirates floppy that you didn't copy at the monthly computer club.1
-
How are your companies doing on writing docs? Is it mandatory/optional? Would you say reading a doc by other team in your company would be enough to understand what their module is doing? Do you write docs per module/file/function? Also please mention main programming language if it's not a secret..6
-
When and how do you improve documentation?
I dont mean "added new/refactored code, gotta document it" but active improvement.
Which feeback channels do you have for your docs?3 -
Trying to get a hunch of Reason ML and saw this in the faqs.
Love it when they take themselves not too seriously in the docs.
source: https://reasonml.github.io/docs/en/...
2 -
sometimes i have to remind myself "dude, the docs explain that shit well! why the hell are you wasting time on crappy resources??"
-
My “DevOps” teammate for a hackathon saves code in Google docs and sends me his contributions on WhatsApp.
Wouldn’t replace him for anyone else though.3 -
I backed this Kickstarter project for a programmable E-ink display called "Displio". The documentation is about 40 lines and is basically just a list of globals without any explanation followed by a link to MomentJS docs. worst of all you have to modify the page with an inspector to see it all.
-
I love the React and Sails docs. The contents are human-readable. Perfect for idiots like me since most docs are $h!+5%&* (hint: Git).2
-
I wish Docker had docs explaining how to migrate EXISTING projects. The pros better outweigh the cons after all this time...5
-
Everytime I learn something, I start to learn something new, and I forget what I just learned. I'm tired of readin docs...3
-
Spotify.
The API is so well documented, that i was able to right all my stuff after 15min of reading the Docs.2 -
I hate doc comments in Rust. They are literally just markdown without any special syntax for documenting stuff. What the actual fuck. Why can't everbody just straight up copy how javadoc does it 😭4
-
Some times I look at inline code documentation and am like:
"That's so beautiful..., but I'm not going to cry". -
Grammarly Beta is now available works Google Docs.
Looks like I won't miss any 'a'/'an' or 'the' anymore in my software documentations8 -
The part I hate the most about working as a dev is writing the docs. The sad thing is that I need to do it on Friday (which is weekend here) as well for my private project (a python library)
-
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. -
@all Next year I wanted to start a project, in which a neural network lerns programming out of a plaintext documentation... Eg: when u click on the button, a messagebox says helloworld gets translated into...
Connect (somestuf)
Fucntion
Showmessage (blablabl)
... For this I would need many people who actually help me out by giving thu neural network examples... Who would be interested in helping that project?? Itwould mean, that u first write that docs and then get the compiled file xD7 -
What happened to the Vue.js docs? Years ago the v2 docs were amazing, simple yet clear and provided detailed information for every API. I picked up v3 after a few years of only using React and the docs are a mess. Guides are not in a logical order, and the API reference is missing a lot of information and forces you to dig through type declarations in the code to figure things out.1
-
What do you think about different English variants in code/docs ?
How you would name variable in UK company?
color ?
colour ?
Why ?14 -
Why the hell is facebook sdk documentation so fucked up?! It doesnt explain anything! And on top of that google doesnt help much either. Grrrrrrrrrrrrrrrrrrrrrr
-
Hey guys,
So I bet you used googl3 docs at a certain point in time, does anybody know if thrre is an opensource library that provides an editor for word files in the browser, similar to google docs?
Thank you!2 -
When you are changing and updating your code update your comments/docs also, there's nothing worse than getting confused by someone else's code to find that the comments/docs are wrong
-
When you are reviewing a PR in which the author has used utilities/libraries that were written by you(which were very generalized and DRY but required for you to read the docs to clearly understand their usage). But instead of using it properly they modify it for their specific usage and made a freaking PR.
I just can't wait to finish the review and slap their face with a printed copy of the FUCKING docs.
Seriously, read the goddamn docs. And, if you do change the lib, please update the doc too. -
Hey folks,
So, rust.
Has anyone any ideas on a decent way to learn it? I feel of all the languages I've ever looked into it has the least about of resources of any discernable quality available. Even the docs can be a but dodge. Would I be better off learning pure c and then migrating? (as I imagine is the pathway of the standard rust user)
Any other recommendations would be deadly!8 -
“Let’s add another style/Layout for h2 so it looks like an h3. The content managers will figure out!” -client PO
MAYBE YOU SHOULD TELL YOUR CONTENT WANKERS TO READ THE FUCKING MANUAL -
Is there any simple documentation editor that allows html export? I found this template: http://surjithctly.github.io/docume... and could of course just write myself something, but is there anything out there that produces such similar/simple docs?2
-
Why the GMail API docs and example were sucks, thats totally not cool! Yeah I need your API right now, but wtf is this docs, its so fcuking ugly. Even my swagger generated docs much better than this... Arrrrghh!2
-
"Oh, i know exactly which file this snippet goes in! I'm glad the author of these docs didn't waste a precious few extra seconds to tell the reader where this is supposed to go."
- An excerpt from "I'm Not an Impostor, and Other Lies Developers Tell Themselves" -
Wait at least an year.
Bcuz after an year, there are enormous amounts of tutorials in youtube that are easier to understand than the official documentation.
(Read the Docs (!fan)) -
Have a freelance job where they require documentation of the code for later development. (+ I'd like to document my personal projects for practice)
Any web devs that could give some pointers on what kind of docs you would like to get if someone hands you a legacy project?
Obviously: comments in code and db structure and relationships1 -
Been trying to scrap Microsoft's docs page for a while now for offline reference, but its been hell. Tried Httrack Copier, Internet Download Manager, Scrapbook e.t.c but it just doesn't do it well. I gave up two months ago. Was looking at the docs today again and saw a link at the bottom that says 'Download PDF'. I almost cried.1
-
- Reading the docs and trying out examples (basically copy paste their example and try it in your computer)
- YouTube videos if I don't understand something from the docs. And to see how people explore various ideas I wouldn't have thought about
- From what I have learned, trying it by myself or applying it to somewhere useful
- Tinkering when free, else move on -
framework authors writing docs about building app: 🔥💪
framework authors writing docs about testing: 💀3 -
Well it's Friday afternoon so nothing quite like writing up some data definition & handover docs to help wind down for the weekend.
-
Where can I find good golang documentation? This is not helping me :\
https://golang.org/pkg/syscall/...5 -
Best documentation have probably been most language docs and references I've worked with, official or otherwise, especially C++. Completeness, consistency, tidiness and examples really help a lot, since I know I can rely on the docs for basically any problem and makes work so much easier since I'll be guaranteed to leave understanding what's up.
Worst documentation has got to be the internal docs we had to create for a seven-man uni project, you couldn't find shit in the sea of docs that were out of date or just plain wrong. It was so much easier to ask whoever was working on that part about the intricacies of the cobbled-together mess than to either read the code or the docs. One absolute mouthbreather was working on the database docs and put in that it stored ArrayLists. Fucking Java ArrayLists in a motherfucking database. One day I am going to rant so hard about this dumbass and it's gonna be a spectacle.
Bonus points goes to the company's public documentation at my internship. It was good and pretty complete, but sometimes there was a document from 2 years ago that had been written by a non-english speaker that was absolutely awful. Some of them were so bad that as soon as I'd finished learning what I needed to, my mentor told me to go and fix the docs, I don't blame him. -
What new tech/framework/library are you most excited about?
I recently found out about Svelte/Sapper, and I've been having a blast with it. It feels like mini-react, but just as powerful - with a few convenience features that I actually wish react had itself. Also their docs page is amazing. I wish all docs were this good.10 -
I love that every time I try to find cURL docs I'm treated to a full array of beauty blogger videos.1
-
Today, me and my boss finally made an SDK work properly on power android and iOS project. This was one though week and a half.
Now the rant part. This took us 1 week and a half because the documentation wasn't entirely correct. The worst, and for me the most irritating part, is the fact that my boss had to be on the telephone with his contact of the other company (the one behind the SDK) only in the end to hear his contact talking to.one of their developers about the flow of the communication.
Long story short, after getting the result from the SDK, we should use that information in another service that's not specified the documentation!!!!
The most annoying is when my bosses contact said to the dev that the service wasn't in the docs, his response was
"One thing is the documentation, the other is real life"
Fuck you, you dev piece of shit, you've wasted over a week of my life trying to make something work following your shitty docs!!!! -
So I’m bit desperate for headless chrome documentation. Went to SO. Was about to ask yes I was about to do tough step. Ask a question.
I clicked blah blah, searched topic: Headless chrome documentation. Nothing previous was there.
So I clicked to proceed to write a question.
And then I asked myself do I really want to put dirt on myself now?
I freakin left and I’m asking our colleague that worked at google, and also I’m going to rather ask directly google for official docs since there is nothing only blogs...1 -
The fucking Unity Transport Layer API documentation is horrible! There's a bunch of information missing, and whenever I try to send data I just get a "NoResources" error. All the docs say about that one is: "No internal resources ro acomplish request.", nothing on forums or google... Worst part is, I've not even started dev that long and Unity has already given me quite some trouble. I hope that's just inexperience, and not Unity being a bitch.2
-
!rant
Just came across the NERSC Docs (https://docs.nersc.gov), absolutely wonderful open source docs by the National Energy Research Scientific Computing Center.
I believe they were written as a guide for people that would be using their super computers, but it's a very good linux beginners guide.
Plus, it looks nice (no visible dark mode tho...). -
Hello anyone with any materials to read and understand polymer 3 javascript library and tutorials apart from the docs
-
Symfony docs suck.
https://symfony.com/doc/current/...
when running
doctrine:migrations:execute
what parameter to pass to the fucking version to not get class not found fucking error?
No explaination in docs, no explaination in command --help. wtf is wrong with symfony devs?9 -
SocketIO can't listen to the event 'ping'. Spent unnecessary time on it. Could've been mentioned in the docs. 😑
-
BeautifulSoup (python module) doc is a single block of text which has an everlasting scrolling and hard to read. Examples are ok, but come on, we're devs, not text parsers. We need clear, clean and visual documentation. I neither like the organization of the Facebook API docs. It was a nightmare to build my first simple app. There are tons of this kind of messy, almost unreadable and confusing docs. It's strange, but usually these kind of docs are related to open source projects. Long life to markdown and github.4
-
How do the companies you work for store company secrets/documentation? Stuff like bitbucket, GitHub, Google docs?8
-
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?!!!!!
-
Read The Docs!!!
Read The Docs!!!
But none of y’all have read the ECMAScript Specification.
Don’t even get me started with W3C… Just stick with your W3Schools5 -
I point out to a guy which documentation and which section he should read to solved his problem, 30minutes later I swing by and the dude sits and watches tutorials on YouTube. I ask him "did you figure it out and solved the problem?", he replies " nah! This tutorial is really great, it shows step by step...blah blah.. I can send it to you! We should all watch it tomorrow after standup" ... Really? He honestly believes were getting paid to drink latte watch tutorials on YouTube? I almost imploded at that point, went into "whatever"-mode and seriously pondered how much mentoring sucks some days. But seriously tutorials on the tube were targeted for 14year old beginners a last time I checked,did the world do a double revolution and left me behind?? Or is that guy just plainly trying to hide the fact how incompetent he is at reading docs?
-
rust attributes should really have docs...
tf is "no_mangle"
and now everyone and their mother checks 12 books and 3 AIs to guess what it means because it has no docs
also all of macros is frankly confusing4 -
Pixabay’s API is great because it offers free (license) stock photos and their keyword search is fairly well.
https://pixabay.com/api/docs/ -
There'sa small group that reads every docs and them answering all of us in stckoverflow
Someday I'll be on that group -
I can't stand having to implement an auth solution using another platform. Probably because I have to follow their API docs and figure out how they work!2
-
If anyone has like an hour or so free at some point, I would appreciate help with optimizing some code. https://github.com/ParzivalWolfram/...
(also i have to write docs on this conceptual CPU because the actual docs are a massive shitshow and this was compiled over like weeks of asking the dude who made it questions)21 -
Damn, .NET devs are really and I mean really bad at writing documentation. It is either over-engineered (anything from Microsoft) to the point you can't find shit. Or it is almost non existent and you have to study the repo and read classes, etc. (ANY .net core nuget for writing CLI apps, heck I would argue almost any nuget in general)
4 pages on github WIKI + examples that cover 20% of use cases are not a bloody documentation mate!!!
I used to be linux + any of Python/Go/JS/Ruby/Elixir guy and almost never had problems with poor documentation.
Now living in Microsoft world with .net and powershell is terrifying.3 -
We are building an application using react and redux and now they need the JavaScript profile of the app. Can some one suggest me the guide or docs for understanding flame graphs in Chrome. I searched but things were not clear in the official chrome docs.
-
Writting some documentation and asked for feedback, soon I felt cheated since "suggestions" were:
1 - Hey, this isn't implemented yet! I'm cutting it out...
2 - Hey! You shouldn't say this is how it works, we were in meeting and discussed that this is how it's gonna be, you need to change it...
Single reviewers, please consider consistency, thank you very much, bye -
Fuck xrdb and it's shitty documentation. Why is it so hard to setup pywal ? Why can't you put simple docs? Configuring anything sucks!1
-
Illusion of interactivity: switching back to a tab with an open google document in google docs, I see a cursor, but it's not yet accepting input, only after I click anywhere inside the document. Might be due to lazy loading browsers tabs, but anyway this is irritating.1
-
Sveltekit progressive enhancement form docs fucking suck.
Arbitrary, non-reproducible examples.
The docs show: return fail(400, { email, missing: true });
The client response says: {
"type": "success",
"status": 204
}
Man, if the docs were monkey-typewritten, they could have warned us first… -
What's your opinion on the fact that some companies take the live coding round of the interview on Google docs?2
Top Tags
Weekly Rant
View