News for hackers. Stuff that matters.
Re:Ask HN: How much detail should I give new users during on... by muzani on Wednesday October 27, 2021 @09:16AM (#29012897)
It seems like you can just include a link to a YouTube tutorial. The users of your tool are probably the visual type.
Re:Ask HN: How much detail should I give new users during on... by AndrewSwift on Wednesday October 27, 2021 @09:52AM (#29013265)
Thanks, we are planning to do that — it will definitely mean that the pages can be simpler

But, it's a lot of work and will take months. And it makes modifying instructions complicated.

In the meantime I need to get people up and running in the next few weeks.

Re:Ask HN: How much detail should I give new users during on... by Jugurtha on Wednesday October 27, 2021 @02:33PM (#29017217)
>But, it's a lot of work and will take months. And it makes modifying instructions complicated.

What's a lot of work and take months? Recording a video of the installation?

Re:Ask HN: How much detail should I give new users during on... by AndrewSwift on Friday October 29, 2021 @04:07AM (#29036360)
It's not just the installation, but how to use the product.

Offhand, I'd say that there are about 35 pages "How to do X", and I can write a simple, profesional page in about 20 minutes.

I can make an amateur video in less than an hour, but a clean, professional video is around 3 hours per item.

It wouldn't take months by itself, but in addition to my other work it will take months.

Thanks for answering. I had hoped the question would get more feedback like "we tried simple documentation but we hemorraged users" or "we spent months working on documentation and it turned out not to be useful".