Textbook Roadmap
From Teaching Open Source
We are currently nearing our first official release of the Teaching Open Source textbook, which is licensed CC-BY-SA.
Contents |
[edit] 0.8 release
[edit] Source
The wiki is the canonical source for writing, but there are other source media used in the publishing of the book.
- Subversion source with DocBook XML - it is in a format to be built using standard DocBook toolchains and especially Publican.
- Publican brand SRPM and RPM - User:Quaid is accountable for submitting these packages in to Fedora for review and inclusion in the main repository; for the meantime this is the source for the Teaching Open Source Publican brand package.
[edit] 0.8.1 release
Our next goal: Release 0.8.1 Fall 2010
For information and participation, the Practical OSS Exploration textbook 0.8.1 planning page is where the next version of this textbook is being planned.
Current status of each chapter:
| Chapter | Writer(s) | Notes |
|---|---|---|
| Practical OSS Exploration - Foreword | Greg De Koenigsberg | |
| Practical OSS Exploration - Introduction to Free and Open Source Software | Greg De Koenigsberg | |
| Practical OSS Exploration - History of Open Source | Leslie Hawthorn | What are things like now and how did things get to be this way? |
| Practical OSS Exploration - The Lay of the Land | Chris Tyler | |
| Practical OSS Exploration - Being Productively Lost | Writer needed | Working in open communities. |
| Practical OSS Exploration - Community Cultures | Leslie Hawthorn | Different types of communities and how they interact. Explanation of communities of practice. |
| Practical OSS Exploration - Open Communities and Diversity | Writer needed | There are significant disparities and non-trivial problems, some of what and why. |
| Practical OSS Exploration - Licensing the Code | Writer needed | Concepts about copyright, copyleft, different types of licenses, and effects of those choices on the code and community. |
| Practical OSS Exploration - Threats and Risks Analysis for Open Source | Writer needed | Review of what can go wrong and consequences; what FUD is and how it's handled. What people forget and do wrong all the time. |
| Practical OSS Exploration - Open for Business | Writer needed | Free software, open source software, and business. Different business models around FOSS to the present. |
| Practical OSS Exploration - Practicing the Open Source Way | Writer needed | How open source has influenced other disciplines in terms of core principles (NOT using software but contribution cultures). |
| Practical OSS Exploration - Requirements for the Code | Writer needed | How do you determine the exact requirements of a feature or enhancement? How do you do this in an open environment where users may be developers and there may be conflict in desired functionality? How do you document these? |
| Practical OSS Exploration - Designing the Code | Writer needed | How do you determine the overall design of a project? How do you determine how your piece fits into the overall design? How do you document this? What are good design practices that result in good code? |
| Practical OSS Exploration - Getting the Code | Greg De Koenigsberg, Mel Chua | |
| Practical OSS Exploration - Building the Code | Greg De Koenigsberg | |
| Practical OSS Exploration - Testing the Code | Writer needed | How do you ensure that your patch/enhancement/bug fix is correct? Organized approaches to testing. |
| Practical OSS Exploration - Debugging the Code | Greg De Koenigsberg | |
| Practical OSS Exploration - Fixing the Code | Jeff Sheltren | |
| Practical OSS Exploration - Explaining the Code: the Art of Documentation | Karsten Wade | |
| Practical OSS Exploration - Release Early, Release Often | Greg De Koenigsberg | |
| Appendix A. Instructor Guide | Greg De Koenigsberg | |
| Appendix B. Glossary of Terms | Mel Chua |
[edit] Proposed new chapters
Sources for this content: Wikipedia and other CC licensed sources; theopensourceway.org; original content production.
These chapters are in the table above:
- Practical OSS Exploration - History of Open Source
- Practical OSS Exploration - Being Productively Lost
- Practical OSS Exploration - Community Cultures
- Practical OSS Exploration - Open Communities and Diversity
- Practical OSS Exploration - Licensing the Code
- Practical OSS Exploration - Threats and Risks Analysis for Open Source
- Practical OSS Exploration - Open for Business
- Practical OSS Exploration - Practicing the Open Source Way
- Practical OSS Exploration - Requirements for the Code
- Practical OSS Exploration - Designing the Code
- Practical OSS Exploration - Testing the Code