DEV Community

Taylor Singletary
Taylor Singletary

Posted on • Originally published at Medium on

4 3

How I fail developers

I don’t tell you about the unknown. Even though it’s known to me.

I won’t tell you what something doesn’t do. Though I know what you want to do instead.

I don’t tell you about the quirks. I don’t want to believe in them.

I don’t clarify how this thing is different from that other thing. I let you figure that out instead.

I don’t tell you why it’s this way. It’s none of your business.

I don’t tell you what I don’t know. Though I know I don’t know it.

I didn’t discover what I didn’t know. I wasn’t curious enough.

I didn’t revise something old. Though I knew it was moldy.

Who edited this?

I was wrong. It took too long. I used too many words. I didn’t use enough.

I forgot to include a picture. Honestly, I forgot how.

My code sample was only hypothetical.

(too many parentheticals)

I didn’t ask for help.

I didn’t test it.

I didn’t change it.

I couldn’t test it.

I couldn’t change it.

My argument for how it could be different did not win.

I just write the docs.

Quadratic AI

Quadratic AI – The Spreadsheet with AI, Code, and Connections

  • AI-Powered Insights: Ask questions in plain English and get instant visualizations
  • Multi-Language Support: Seamlessly switch between Python, SQL, and JavaScript in one workspace
  • Zero Setup Required: Connect to databases or drag-and-drop files straight from your browser
  • Live Collaboration: Work together in real-time, no matter where your team is located
  • Beyond Formulas: Tackle complex analysis that traditional spreadsheets can't handle

Get started for free.

Watch The Demo 📊✨

Top comments (1)

Collapse
 
rimutaka profile image
Max

Man, this is gold :) I would print and frame it on a wall, if I had a printer, or a wall.
Seriously, it is very good.
I'm nursing my injured pride after loosing a week-long battle against bad docs. I totally get what you are saying.
Why bother? Docs are not code - they don't fail an automated unit test.

Come back and write some more.

Image of Timescale

📊 Benchmarking Databases for Real-Time Analytics Applications

Benchmarking Timescale, Clickhouse, Postgres, MySQL, MongoDB, and DuckDB for real-time analytics. Introducing RTABench 🚀

Read full post →

👋 Kindness is contagious

Engage with a wealth of insights in this thoughtful article, valued within the supportive DEV Community. Coders of every background are welcome to join in and add to our collective wisdom.

A sincere "thank you" often brightens someone’s day. Share your gratitude in the comments below!

On DEV, the act of sharing knowledge eases our journey and fortifies our community ties. Found value in this? A quick thank you to the author can make a significant impact.

Okay