From Teaching Open Source
Contents |
[edit] Textbook Roadmap
It's a big chunk of work, writing a textbook. This is how we're gonna get the first draft of this textbook done by March 1.
Textbook will be licensed CC-BY-SA.
[edit] TODO: finish First Draft of every chapter
Current status of each chapter:
| Chapter | Owner(s) | % Complete (1st draft) | Notes |
|---|---|---|---|
| Foreword | Greg De Koenigsberg | 100% | |
| 1. Introduction to Free and Open Source Software | Greg De Koenigsberg | 100% | |
| 2. The Lay of the Land | Chris Tyler | 10% | |
| 3. On Being a Beginner | Dave Humphrey | 5% | |
| 4. Getting the Code | Greg De Koenigsberg, Mel Chua | 90% | |
| 5. Building the Code | Greg De Koenigsberg | 90% | |
| 6. Debugging the Code | Greg De Koenigsberg, Max Spevack | 75% | |
| 7. Fixing the Code | Greg De Koenigsberg | 0% | |
| 8. Explaining the Code: the Art of Documentation | Karsten Wade | 75%+ | |
| 9. Release Early, Release Often | Greg De Koenigsberg | 0% |
[edit] TODO: unify structure and formatting
All of our chapters are very scattered in both structure and formatting. Should be pretty simple, even at this early stage, to identify top-level, second-level, and third-level headings. We want to (a) make sure that these headings are fairly uniform throughout the book, and (b) make sure that they are internally correct and suggest the proper outline structure, which will help us write the bits that we haven't written yet.
Things to include in every chapter:
- A list of things you should know how to do by the end.
- Exercises after every major section.
- A review of key points at the end that should map to the list at the beginning of the chapter.
[edit] TODO: exercise brainstorm
Exercises are the heart of this text. It's a central goal to ensure that almost every exercise has a real and meaningful impact on some project. This is one of those things that we might be able to have a killer sprint around: coming up with tons of awesome exercises!