So I told my wife one week ago: "Yeah, you should totally learn to code as well!"

Yesterday a package arrived, containing a really beautiful hardcover book bound in leather, with a gold foil image of a snake debossed into the cover, with the text "In the face of ambiguity -- Refuse the temptation to guess" on it.

Well, OK, that's weird.

My wife snatches it and says: "I had that custom made by a book binder". I flip through it. It contains the Python 3.9 language reference, and the PEP 8 styleguide.

While I usually dislike paper dev books because they become outdated over time, I'm perplexed by this one, because of how much effort and craftsmanship went in to it. I'm even a little jealous.

So, this morning I was putting dishes into the dishwasher, and she says: "Please let me do that". I ask: "Am I doing anything wrong?"

Wife responds: "Well, it's not necessarily wrong, I mean, it works, doesn't it? But your methods aren't very pythonic. Your conventions aren't elegant at all". I don't think I've heard anyone say the word "pythonic" to me in over a decade.

And just now my wife was looking over my shoulder as I was debugging some lower level Rust code filled with network buffers and hex literals, and she says: "Pffffff unbelievable, I thought you were a senior developer. That code is really bad, there are way too many abbreviated things. Readability counts! I bet if you used Python, your code would actually work!"

I think I might have released something really evil upon the world.

Started a new job a month ago. I’m the only real frontend developer here. I come from a company with 10+. Now i’m working with a old ux guy. Mr. UX teached me the usage of a styleguide. This styleguide is a fucking mess. The legacy code is a fucking mess. They way of working, up for improvement.
I have a dream...

Why aren't styleguides made by democratic descisions?
Just ask 1m devs and do whats done the most.

Part of the PR feedback was the use of capitals and the conventions. I tried to look up some backup documentation of angular in the styleguide regarding this topic. Didnt find any.

His answer was that it’s a C# convention. DUDE IM NOT PROGRAMMING IN C# AM I ?! You are mixing up conventions between ts, js, ng and now C# how the fuck am i ever going to follow this?!

I love it when developers and designers say "we've build our own UI-framework/ online living styleguide" and how that was a lot of work and it just consists of: Input, Button, some headlines and colors. And it also does not grow a tiny module/bit the next 3 years. And if you ask to add a new button-size everybody is just like "Noooooo, we already have two sizes! Isn't that enough? Do you really need one more? Doesn't this dilute the overall display of the corporate design on the website?" Because for real it is not a living online styleguide that automatically transports changes to every site as intended in the first place but is rather a small bundle of HTML- and CSS-Snippets...

So on friday i got a super speed course on how to develop a new styleguide in Angular with Storybook. Superspeed because fellow dev went on vacation for a week. Today is monday and i forgot everything i need to know.

This is gonna be a difficult week :/

Not a rant, but has anyone here had any experience developing a StyleGuide?

I'm looking at building one that could document JavaScript and AngularJS as well as CSS etc.

Having a hard time finding a generator/tool that would work.

If not I'll look into building one myself... 😬

Last days i’m digging in the legacy of this company. As if the first styleguide i had to work with wasnt worse enough i found two others now that are using different frameworks and are not part of the deployment process.

So far i had fractal, now busy with patternlab and yesterday foundation and the latest one; storybook.

There is duplicate code everywhere how on earth do they expect me to keep any kind of overview in this freaking mess they made?!