Paolo Amoroso

As a text-first boomer I completely agree screenshots and videos are no substitute for written documentation. The mileage of younger generations may vary.

"When you throw a screenshot out into Notion (Wiki, Confluence, et cetera), you’re effectively defining a word WITH the word."

https://joshtronic.com/2022/08/21/screenshots-are-not-documentation

#documentation

Screenshots are not documentation by Josh Sherman

Repeat after me, “screenshots are NOT documentation”. Neither are videos, looms, or animated GIFs. Links to Google Docs or random websites, better, but not best. The aforementioned media types are often confused with real, honest to glob, documentation. When you’re asked to document something, you’re being asked to describe it.

May 9, 2023 at 3:19pmWeb
Show threadapgarciaMay 9, 2023
@amoroso this gen-xer completely agrees. thinking that i'm missing out on some valuable information, i experimented a bit with running videos through whisper, with fair results i suppose. my verdict, though, was that it's not really worth it.
https://openai.com/research/whisper
Introducing Whisper

We’ve trained and are open-sourcing a neural net called Whisper that approaches human level robustness and accuracy on English speech recognition.

Show threadPaolo AmorosoMay 9, 2023
@apgarcia I haven't looked into those AI tools yet, the pace of change has been overwhelming so far.
Show threadjohnbessaMay 9, 2023

@amoroso
With my disastrous experience with #Kubuntu, a key idea comes back:

Design the system from the manual - not the documentation, the manual.

Write the manual sensibly, then organize the objects. Then write the code.

But before that, oust objectors as they can easily rationalize sabotaging beneficial change.

Show threadPaolo AmorosoMay 9, 2023
@johnbessa Although I used Ubuntu a while back I'm not familiar with Kubuntu. What was so disastrous about the experience?
Show threadjohnbessaMay 9, 2023
@amoroso A lot. I use the word "experience" sarcastically. I hope you don't mind. I need to run.