Textbook 0.9 planning notes

From Teaching Open Source

Jump to: navigation, search

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