Roughly six or seven years have passed since I was last at the dentist's and after having been putting off making an appointment for just over a year now I finally decided to man up and go make an appointment today.
Of course, the last time I was there I was in high school and somebody, probably mum, simply told me when and where to go and that was that. I may even have been on some sort of reoccuring pattern and the dentist told me when to come next time or something. Don't really remember.
Since I'm now a bit older this means an appropriate dentist isn't even in the same building anymore. Luckily the new building is across the street.
So I go there and immediately have to make a decision. This thing is like a huge repository of stuff ... think of it like github. You are greeted with a big sign essentially saying "Some interesting projects this way. There are some that other way as well. Oh and some are upstairs"
Picked the Dentist project and walked through a door.
The project consisted of roughly two modules. There was a big Waiting Room module, which I think doubles as a homegrown community forum, an RTG module - might be just a single executable. There was also a module looking more like a collection of executables, called Dentists.
Naturally there was no documentation. Well, I'm lying, of course there was some documentaiton. A document listed all the executables in this project and there was a document suggesting I should have a running OS before I attempt to use an executable ... something about things being pricey if I don't.
You look at these executables and nothing makes sense.
Every executable is described only by its name. Other than that the only information was one executable advertising itself as just having moved to a different location, presumably within the same project, and another saying I should not under any circumstances try to execute it first.
In a sense this was the worst open source project I ever attempted to use. There was no indication of a project owner or anyone I could contact in case I had any questions. The community forum also looked particularly dead ... there was one member online but I think he was idling and probably wouldn't answer my questions even if I asked.
There were some more executables around the corner, but nothing that could really explain what's going on here or what the entry point for the project is. Where to start picking it apart and figuring out how to use this thing.
Oh and I also found some random piece of documentation that said all executables have a latency of roughly a month or two. Although I'm not certain how this is useful if you can't even run them in the first place ... maybe they run as a server and you have to somehow issue a request?
All in all a really baffling and confusing experience. In the end I just left. Think I need to find someone with experience using this project or some sort of tutorial ...
Learned something new?
Read more Software Engineering Lessons from Production
I write articles with real insight into the career and skills of a modern software engineer. "Raw and honest from the heart!" as one reader described them. Fueled by lessons learned over 20 years of building production code for side-projects, small businesses, and hyper growth startups. Both successful and not.
Subscribe below 👇
Software Engineering Lessons from Production
Join Swizec's Newsletter and get insightful emails 💌 on mindsets, tactics, and technical skills for your career. Real lessons from building production software. No bullshit.
"Man, love your simple writing! Yours is the only newsletter I open and only blog that I give a fuck to read & scroll till the end. And wow always take away lessons with me. Inspiring! And very relatable. 👌"
Senior Mindset Book
Get promoted, earn a bigger salary, work for top companiesLearn more
Have a burning question that you think I can answer? Hit me up on twitter and I'll do my best.
Who am I and who do I help? I'm Swizec Teller and I turn coders into engineers with "Raw and honest from the heart!" writing. No bullshit. Real insights into the career and skills of a modern software engineer.
Want to become a true senior engineer? Take ownership, have autonomy, and be a force multiplier on your team. The Senior Engineer Mindset ebook can help 👉 swizec.com/senior-mindset. These are the shifts in mindset that unlocked my career.
Curious about Serverless and the modern backend? Check out Serverless Handbook, for frontend engineers 👉 ServerlessHandbook.dev
Want to Stop copy pasting D3 examples and create data visualizations of your own? Learn how to build scalable dataviz React components your whole team can understand with React for Data Visualization
Did someone amazing share this letter with you? Wonderful! You can sign up for my weekly letters for software engineers on their path to greatness, here: swizec.com/blog
By the way, just in case no one has told you it yet today: I love and appreciate you for who you are ❤️