3 ms·
There will be plenty of time for the new programmer to get their google-fu from reading other people's crappy documentation. As a writer, though, it's your job
by andrewflnr 15y ago
There will be plenty of time for the new programmer to get their google-fu from reading other people's crappy documentation. As a writer, though, it's your job to make your piece as useful as possible for your intended audience. This means practical examples, because that's often the best way to learn in this type of scenario.
The point about PiL is not that it's a bad book, it's that it's a bad introduction for a non-programmer. PiL was extremely useful to me when I already knew C++ and Python, but I can also see that if it had been my first programming resource I would have been in trouble.