Conversation

Notices

1. Embed this notice
   Paul Cantrell (inthehands@hachyderm.io)'s status on Wednesday, 28-Aug-2024 05:57:04 JST Paul Cantrell

   in reply to

   • masukomi
   • Hrefna (DHC)
   • Dachary

   @masukomi @gregdosh @hrefna @dachary
   Yeah. It’s a tough one: there’s a whole lot to the idea that code should explain itself well, and I’ve definitely seen people lean on verbose, meandering docs that get stale fast when they should really have thought about renaming some things in the code first.

   But that hard-core rejection of docs you describe is just…extremely unhelpful. (Perhaps born of a hostility to the humanities?)

   • Embed this notice
     masukomi (masukomi@connectified.com)'s status on Wednesday, 28-Aug-2024 05:57:10 JST masukomi

     • Hrefna (DHC)
     • Dachary

     @gregdosh @inthehands @hrefna I am SO tired of arguing with "expert" programmers that think that because when _they_ read code everything is "obvious", that they spout the stupid "code should be self documenting" line. They never seem to "get" the things you said.

     @dachary's a programmer/tech writer and her super-power is being able to put herself in the shoes of a reader who doesn't know anything and giving them the tools they need to succeed.