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

The first point about documentation really has to do with the question: whom are you willing to support?

Instead of seeing it as "users of X platform", I think it's more useful to divide user groups into:

1. Completely non-technical users who, at worst, wouldn't know how to download anything, and at best only know how to install from an ".exe" file;

2. Middle-ground users who, at worst, are not willing to learn your preferred way of installation, or at best, are new to non-common installation methods;

3. Technically proficient users who, at worst, have arbitrary reasons for disliking your preferred way of installation, or at best, have legitimate reasons for disliking it;

4. Your ideal technically proficient users.

FOSS is often geared towards the fourth category, and for good reason. But if you want your tool to be adopted more widely, you have to learn more about those other user groups, and how to support them beyond documentation.

And here I'd say it's also fair to look for good reasons or funding for that extra support, because if it's not rewarding work, it doesn't have to stay free as in free beer (even if it's FOSS).



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

Search: