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?!

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?!