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

I think it's because people are getting worse at explaining things and writing docs.

As a student many times I wanted to learn how things work, but most tutorials/docs just ask you to type in a few magical lines without much explanation. Maybe the authors think their audience won't understand anyway, but I think it's the authors' ineptitude if they can't explain what their programs do in an accessible way.

I really hope there could be more projects like i3[1] and flask[2].

1: http://i3wm.org/docs/userguide.html 2: http://flask.pocoo.org/docs/0.10/



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

Search: