You are previewing Bug Advocacy: A BBST Workbook.
O'Reilly logo
Bug Advocacy: A BBST Workbook

Book Description

Bug Advocacy, second in the BBST workbook series, supports students and self-studiers who want a context-driven introduction to black box software testing. Used in parallel with the instructional materials provided at the Center for Software Testing Education and Research (testingeducation.org/BBST), the workbook helps readers understand that bug reports are not just neutral technical reports. They are persuasive documents. The key goal of the bug report author is to provide high-quality information, well written, to help stakeholders make wise decisions about which bugs to fix. Key ideas in this book include:

  • Defining key concepts (such as software error, quality, and the bug processing workflow)

  • The scope of bug reporting (what to report as bugs, and what information to include)

  • Bug reporting as persuasive writing

  • Bug investigation to discover harsher failures and simpler replication conditions

  • Excuses and reasons for not fixing bugs

  • Making bugs reproducible

  • Lessons from the psychology of decision-making: bug-handling as a multiple-decision process dominated by heuristics and biases and

  • Style and structure of well-written reports

  • The learning objectives in this book include this content, plus improving your abilities / skills to:

  • evaluate bug reports written by others

  • revise / strengthen reports written by others

  • write more persuasively (considering the interests and concerns of your audience),

  • participate effectively in distributed, multinational workgroup projects

  • Table of Contents

    1. Titlepage
    2. About the Authors
    3. Table of Contents
    4. Preface
      1. About this Workbook
      2. Who This Book Is For
      3. About This Book’s Structure
      4. About BBST
      5. About The Design Of The Bug Advocacy Course
    5. Lesson 1: Basic Concepts
      1. Lesson Introduction
      2. Readings
      3. Orientation: Quality Definitions
      4. Slides And Notes
      5. Application: Joining An Open Source Project
      6. Authors’ Reflection On Lesson 1
    6. Lesson 2: Effective Advocacy: Making People Want To Fix The Bug
      1. Lesson Introduction
      2. Readings
      3. Orientation: Your Experience With Bug Reporting
      4. Orientation: Tell Us What Bug You Are Working On
      5. Slides And Notes
      6. Application: Evaluating Bug Reports: Phase 1
      7. Authors’ Reflection On Lesson 2
    7. Lesson 3: Writing Clear Bug Reports
      1. Lesson Introduction
      2. Readings
      3. Orientation: Writing An Attention-Grabbing Bug Summary
      4. Slides And Notes
      5. Application: Evaluating Bug Reports
      6. About That Bug Evaluation Guide
      7. Authors’ Reflection On Lesson 3
    8. Lesson 4: Irreproducible Bugs
      1. Lesson Introduction
      2. Readings
      3. Slides And Notes
      4. Authors’ Reflection On Lesson 4
    9. Lesson 5: Bugs That Could Be Dismissed As Unreasonable Or Unrealistic
      1. Lesson Introduction
      2. Readings
      3. Slides And Notes
      4. Application: Evaluating Bug Reports, Phase 2
      5. Authors’ Reflection On Lesson 5
    10. Lesson 6: Credibility and Influence
      1. Lesson Introduction
      2. Readings
      3. Slides And Notes
      4. Supplementary Thoughts On Decision Theory
      5. Application: Evaluating Bug Reports: Phase 3
      6. Application: Applying The Decision-Making Model
      7. Authors’ Reflection On Lesson 6
    11. Assignment: Replicate And Edit Bugs
      1. This Appendix Contains The Assignment Instructions
      2. The Assignment Workflow
      3. The Assignment’s Details
      4. How To Evaluate A Bug Report
    12. Feedback on Activities
      1. Introduction: The Answers At The Back Of The Book
      2. Orientation: Writing An Attention-Grabbing Bug Summary
      3. Application: Apply The Decision-Making Model
    13. Advice for Answering Essay Exams
      1. Overview
      2. Answering Essay Exams Well
    14. References
    15. Index