fantastic read. I only read the first part but already found a few good tips:
"Most software projects have really bad - or non-existent - tutorials. Tutorials are what will turn your learners into users. A bad or missing tutorial will prevent your project from acquiring new users.
Good tutorials are very difficult to write. They need to be useful for the beginner, easy to follow, meaningful and extremely robust."