From Teaching Open Source
Some issues that we should consider for the 0.9 Release:
- Some chapters begin with a very standard "what you should learn in this chapter" section. Other chapters lack this. We really should strive to make that consistent across all chapters.
- There are a number of terms about which we assume previous knowledge. One simple option is to hyperlink to good explanations of these terms externally; but a better solution might be to link to a glossary at the end of the text. We're starting to collect these in our Glossary of Terms.
- We should explain who this book is for (for instance, in a section in the introduction titled "who this book is for"). This will be a (nonexclusive) description of our target audience that helps people understand the assumptions we may be making as we write. One suggestion was to create personas for the book. FIX in Foreward
- Make a student-like session working on code, e.g. "Here is an example of a social moment on IRC:" and "Here is an example of working on code in IRC:" FIX in The Lay of the Land