• 0 Posts
  • 20 Comments
Joined 3 months ago
cake
Cake day: July 6th, 2024

help-circle

  • At my job, we have an error code that is similar to this. On the frontend, it’s just like error 123.

    But in our internal error logs, it’s because the user submitted their credit card, didnt fully confirm, press back, removed all the items out of their cart, removed their credit card, then found their way back to the submit button through the browser history and attempted to submit without a card or a cart. Nothing would submit and no error was shown, but it was UI error.

    It’s super convoluted. And we absolutely wanted to shoot the tester who gave us this use case.





  • I’m not as much vitriol as others about Clean Code, but I will argue that engineers who preach the book as some sort of scripture are really obnoxious.

    I love the Single Responsibility Principle, in theory.

    What I don’t like is when devs try to refactor everything to that idea to achieve “Clean Code”. I’ve seen devs over-architect a solution, turning one function into many, because they don’t want to break that rule. Then point to this book as to WHY their code is now 20x longer than it needs to be.

    It also doesn’t help that every recommendation about good programming books include this.

    It’s like recommending a Fitness book from the 70s - information made sense at the time, but new research has made a lot of the advice questionable.

    My main issue is the whole “Uncle Bob” persona. Robert C Martin is sexist and a racist, and has been uninvited by conferences. We don’t need that type of toxicity in the industry.






  • as a chronic documentation reader, the best advice i can give is to document everything Anything that the user can and will potentially interact with, should be extensively documented, including syntax and behavior.

    I don’t know about that. I’ve read some terrible documentation that had everything under the sun. Right now in the library I’m using, the documentation has every available class, every single method, what it’s purpose.

    But how to actually use the damn thing? I have to look up blog posts and videos. I actually found someone’s website that had notes about various features that are better than the docs.

    There’s a delicate balance of signal vs noise.






  • Fun story! At a conference, I asked this vendor (the company collapsed now) if I can see their documentation. The obvious sales person made a big stink how it’s only for paid customers and I can see it when I paid.

    I told him how stupid it was since his competitors have their docs open.

    During a conference’s event where they parade their sponsors, the vendor got on stage and called me out with “And paid customers will have a wealth of support, like developer documentation… Especially for you [name]”.

    In my nerd rage, I shouted from the audience “What kind of shit software is afraid to share their developer docs publicly?” I was escorted out by security.

    And during the night event when everyone mingles (including sponsors), the guy didn’t show up. And apparently, news got around where by the last day of the event, the entire booth was taken down.

    I dunno if it was me shouting and everyone agreeing with me, or the conference realizing that attacking a paid member of the audience wasn’t a good idea and told him to leave.

    Either way… Tell it to their faces when their product isn’t dev friendly. These charlatans seem to get bolder and bolder with their garbage.




  • That’s actually a valid skill to know when to tell the AI that it’s wrong.

    A few months ago, I had to talk to my juniors to think critically about the shitty code that AI was generating. I was getting sick of clearly copy-pasted code from chatGPT and the junior not knowing what the fuck they were submitting to code review.