News for hackers. Stuff that matters.
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by vasco on Tuesday November 22, 2022 @03:35PM (#33711113)
Have you worked with non-technical teams, ever? Perhaps in teams of very young and gamer-type people this would work, but in any real world team I've been in, this would not in fact be easy unless there's a real time preview and a button you can click that auto-generates that snippet. People would forget the exclamation mark, mixup the brackets with the parenthesis, not know how to reference the right path to the image, and ask a developer to help them out.
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by someguydave on Tuesday November 22, 2022 @03:42PM (#33711208)
If someone is confused by markdown syntax it is hard to imagine how they contribute professionally.
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by mym1990 on Tuesday November 22, 2022 @03:48PM (#33711291)
Maybe you should try to imagine a little harder. "If You Judge a Fish by Its Ability to Climb a Tree, It Will Live Its Whole Life Believing that It is Stupid"...or in this case you will live your whole life believing every non-technical person around you is stupid...which just sounds miserable for everyone involved.
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by rcarr on Tuesday November 22, 2022 @03:43PM (#33711230)
Well presumably this would be less of an issue if you had easy to use, easy to search and easy to maintain documentation, you know, maybe in the form of markdown files with a search bar where you could type 'how to paste image into documentation' in case you forgot...

At the end of the day, if you've got someone who can't work out how to drag a file into a folder and then type ![imagename](imagename.jpg) after you've shown them a couple of times, is this really the person you want writing the documentation for your process?

Re:The Perks of a High-Documentation, Low-Meeting Work Culture by koonsolo on Wednesday November 23, 2022 @03:53AM (#33716725)
At the end of the day, if you've got someone that can't figure out there are people that are not good at technical things, do you really want them to develop your user facing software?
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by rcarr on Friday November 25, 2022 @01:12PM (#33745178)
Ok mate we’ll all go back to living in huts because we decided we had to go at the pace of the slowest people in society.