> > This also may be an example of why there is a lack of documentation with
> > Linux/Free/Open Source software: why bother write it? People won't follow
> > instructions anyway.
>
> Oh there's plenty of documentation. It's just that much of it written
> like reference manuals. You don't give someone new to a subject a
> _reference manual_; you give them a tutorial. But coders don't like to
> write tutorials.
It's not only that - often, when coders try to write tutorials, they turn out sounding like reference manuals anyway. It's difficult a lot of times to get an outside perspective on a piece of software that you know intimately inside and out. The best tutorials, IMO, are those written by intermediate-level users who can understand the reference manuals but are looking for something that resembles English a little more closely.
$0.02
Levi
This archive was generated by hypermail 2.1.3 : Fri Aug 01 2014 - 18:22:27 EDT