Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

I think non-technical people, who may have literally never seen a commandline, like seeing someone walk through it (and probably explain context along the way). Helps ensure them they are doing the correct things.


I've seen probably too many terminals, but a video that actually demonstrates things (when to press the keys, for how long, what's the expected response from the installer, and so on, and so on) seems super helpful and easy to follow! (Even if it's worse in many regards, like terseness, accessibility for blind people, and so on.)


Agreed. Also people tend to add a lot of context when they're talking through a process. That often gets left out when writing.

I've written docs at work intended for non (or less) technical people and it's a pain in the ass to try and get screenshots of expected inputs/outputs, try to predict every question or misunderstanding and make the writing clear. There has been more than a few times I wished I could just record a video.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: