Chapter-12 Learnings>>Mistakes

Introduction

This is the most important chapter of our Docs. This chapter delves into a reflective journey, analyzing bugs and issues encountered in various segments of our technology stack: Frontend, Backend, Admin Portal, and Third-Party Integration. The essence of this chapter lies not in attributing blame but in fostering a culture of collective learning. Every bug, mistake, or downtime is an opportunity to grow. By dissecting these incidents, we solidify our understanding and improve our processes. By learning from our past, we pave the way for a more robust, efficient, and error-resistant Bolbhav product.

Objectives

  1. Enhancing our ability to foresee and mitigate potential bugs in future developments, and

  2. Building a repository of knowledge for current and future team members.

Postmortem Analysis: A Learning Template

Each incident will undergo a 'Postmortem Analysis', broken down into:

  1. **What Happened: **A clear, concise description of the incident.

  2. **Cause:**Identifying and outlining the potential causes.

  3. **Measures: **Strategies and actions to avoid recurrence.

  4. Potential bugs: Can this tell us about any other similar bug.

  5. **Resources: **Helpful resources related to the issue.

This standardized format ensures a structured and thorough analysis of each incident.

Subsections

This chapter has following five sub-sections:

  1. Frontend: Addressing issues related to Bolbhav’s Android application.

  2. Backend: Focusing on server-side problems, including database errors and API issues.

  3. Admin Portal: Examining challenges within Bolbhav’s internal admin interface.

  4. Third-Party Integration: Investigating issues stemming from external services and APIs.

  5. Non-Technical: Reviewing operational mistakes and their learnings.

Guiding Principles

Following practices will be guiding principles to write this chapter:

  1. Problem not person: Fostering a transparent environment where team members freely share mistakes and learnings. Problem is discussed rather than who made that problem.

  2. Meticulous Documentation: Carefully recording each incident, its resolution, and strategies for prevention.

  3. Cross-Functional Reviews: Involving team members from diverse functions in the postmortem analysis.

  4. Continuous Learning: Ensuring the chapter is regularly updated with new insights and learnings.

Last updated