"RTFM" is inherently unkind. Let's ditch it altogether. ♂️ https://t.co/Zgifa8qcyl
— Compassionate Coding (@compassioncode) August 25, 2017
It’s Time to Retire “RTFM” – Compassionate Coding – Medium.
When you use RTFM, you’re saying, “Not only am I not going to help you, but I also want to make sure that you feel ashamed about your inability to help yourself.”
Maybe there are some ideas for the “Blame” button in GitHub to consider as well, would “Credits” work? Blame scares off folks from contributing, getting blamed for things is not usually fun, every thing breaks, we can fix it together.
Adafruit publishes a wide range of writing and video content, including interviews and reporting on the maker market and the wider technology world. Our standards page is intended as a guide to best practices that Adafruit uses, as well as an outline of the ethical standards Adafruit aspires to. While Adafruit is not an independent journalistic institution, Adafruit strives to be a fair, informative, and positive voice within the community – check it out here: adafruit.com/editorialstandards
Adafruit is on Mastodon, join in! adafruit.com/mastodon
Stop breadboarding and soldering – start making immediately! Adafruit’s Circuit Playground is jam-packed with LEDs, sensors, buttons, alligator clip pads and more. Build projects with Circuit Playground in a few minutes with the drag-and-drop MakeCode programming site, learn computer science using the CS Discoveries class on code.org, jump into CircuitPython to learn Python and hardware together, TinyGO, or even use the Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for CircuitPython, MakeCode, and Arduino. It has a powerful processor, 10 NeoPixels, mini speaker, InfraRed receive and transmit, two buttons, a switch, 14 alligator clip pads, and lots of sensors: capacitive touch, IR proximity, temperature, light, motion and sound. A whole wide world of electronics and coding is waiting for you, and it fits in the palm of your hand.
Have an amazing project to share? The Electronics Show and Tell is every Wednesday at 7pm ET! To join, head over to YouTube and check out the show’s live chat – we’ll post the link there.
Join us every Wednesday night at 8pm ET for Ask an Engineer!
Join over 36,000+ makers on Adafruit’s Discord channels and be part of the community! http://adafru.it/discord
CircuitPython – The easiest way to program microcontrollers – CircuitPython.org
Maker Business — Philips, an electronics giant, has faded from its former glory
Wearables — Use a light touch
Electronics — Lost signal? Have no fear!
Python for Microcontrollers — Python on Microcontrollers Newsletter: Pi Day, GitHub 2FA and much more! #CircuitPython #Python #micropython @ThePSF @Raspberry_Pi
Adafruit IoT Monthly — Boxing Glove Tracker, Disconnecting Smart Appliances, and more!
Microsoft MakeCode — MakeCode Thank You!
EYE on NPI — Maxim’s Himalaya uSLIC Step-Down Power Module #EyeOnNPI @maximintegrated @digikey
New Products – Adafruit Industries – Makers, hackers, artists, designers and engineers! — #NewProducts 3/15/23 Feat. Adafruit CAN Bus FeatherWing – MCP2515!
Get the only spam-free daily newsletter about wearables, running a "maker business", electronic tips and more! Subscribe at AdafruitDaily.com !
3 Comments
Sorry, the comment form is closed at this time.
I have similar feelings about Git and Subversion’s blame feature.
A better name for the feature may be ‘Line Owner’. Like that the version control system is only stating a fact, versus immediately providing someone to blame for something.
I work in tech support. I deal with this problem a lot. I typically take a snippet from a manual and e-mail to the person who had asked the question. I also tell them that the snippet was lifted from the particular manual it came from. In other cases, over the phone, I’ve lead people to our document repository, had them open the appropriate document, then pointed them to the place that they were looking for–teach a man to fish.
I’ve had good success without offending anyone.
Subversion has the command "svn blame", but also aliases "svn praise" and "svn annotate". Their thinking is in the right direction.