Conversation

Notices

1. Embed this notice
   brokenix (brokenix@emacs.ch)'s status on Thursday, 21-Sep-2023 08:22:24 JST brokenix

   Don't write documentation in Markdown | Hacker News

   "Developers: reStructuredText is better than .txt and .md because it has feature XYZ, and it's special syntax is great.

   Researchers: .rst and .md are poor with math symbols, please write the technical documentation in beautiful LaTeX with rendered symbols.

   Managers: If I can't read or edit it easily, I'll hire someone to rewrite it using Word or Google Docs.

   Everyone: Here's the Word document."
   https://news.ycombinator.com/item?id=22675165#:~:text=Developers%3A%20reStructuredText%20is,the%20Word%20document.

   • Embed this notice
     screwlisp (screwtape@mastodon.sdf.org)'s status on Thursday, 21-Sep-2023 08:22:23 JST screwlisp

     in reply to

     @brokenix am I alone in responding to any message with an attached docx file, "I unzipped the file you sent me but I'm not sure what to do next"

     Haelwenn /элвэн/ :triskell: likes this.
   • Embed this notice
     Haelwenn /элвэн/ :triskell: (lanodan@queer.hacktivis.me)'s status on Thursday, 21-Sep-2023 08:26:52 JST Haelwenn /элвэн/ :triskell:

     in reply to
     @brokenix Raw HTML is where it's at, everyone can read and edit those, including nerds like me without a word processor.