Software Product Development Principles

-
All software products are a result of hundreds or thousands of small decisions made by a group of people overtime. Not everything can be captured in Product Requirement Documents (PRDs) and Jira (a project management tool) tickets for the engineers to make these small decisions. Furthermore, with remote and globalized workforces, it has become increasingly important that all engineers operate with the same set of principles to create a good product. Over the years, I found the following principles to be helpful: 


1. Build trust with the users 

For example, if you are releasing an update, ensure that it does not disrupt customer operations. 

2. Let fresh eyes verify the code before release (peer code review) 

Framework, culture, and tooling are needed to support this principle. 

3. Everything that could change with time should be implemented as a configurable parameter (high configurability)

Over-configurability can lead to increased complexity. 

4. Speed does not mean lower quality for the user- implement fewer features with quality rather than more features with low quality. 

Adopt a system for feature prioritization and quality assurance. 

5. Understand how the code fits into the big picture (integration testing) 

Critical for CI/CD development framework. 

6. Document what can go wrong (understand risks and have a mitigation plan)

For example, have rollback plans if software update fails. 

7. Ensure code does not lower the data integrity of the system 

Adopt data validation techniques. 

8. Understand the “why” behind the requirement (user empathy) 

Get a clear idea of what problem is user trying to solve. 

9. Simplify 

Increases speed, reduces bugs, and lowers maintenance costs. 

10. Frequent small deliverables are better than infrequent large deliverables

This is the main idea behind Agile development. 

11. Write release notes that both frequent and infrequent users of the product can understand

Follow the same template every time. 




Having principles is not enough. To build good software products, we must embody these principles daily, ensuring they guide our actions and decisions at every step.

Popular posts from this blog

Obituary: Charles T. Munger

-
Image
My hero, Charlie Munger , passed away on November 28th, 2023. He was 99 years old.  I met Munger in 2007 at my first Berkshire Hathaway shareholder meeting . It was admiration at first few words. I liked his depth of understanding in multiple domains, his honesty, and his willingness to share his wisdom. Since then I have read all his available writings and seen him many times in Omaha or Los Angeles at various shareholder meetings. He profoundly influenced Warren Buffett and the entire investing and business world. The world has lost a great leader, thinker, and teacher.  Munger's response to my letter      Since meeting Munger, I continue to learn from him and share what I am learning.  Following are a few Munger teachings that have become my habits:  1. Inversion: When you want to solve a problem, start with inverting the problem. For example, if you have to figure out how to keep the airplanes safe, work on figuring out how they can crash.  2. Multi-disciplinary thinking:
Read more

Marry the best who will have you and other wisdom from Munger and Buffett

-
I spent the last weekend in Omaha, Nebraska with two of the my heroes- Charlie Munger and Warren Buffett . After attending the Berkshire Hathaway (BH) for a few years, I still get amazed how a shareholder meeting attracts 40,000+ people and the meeting is about two guys having fun. Everyone else  enjoys watching them have fun. The format is six hours of open Q&A. There is no preparation by Munger and Buffett. Anyone can ask anything about anything expect what BH is going to buy/sell next. You will see it in the notes  that a wide variety of topics are covered. Notes from previous years are available here . The David Sokol issue was covered by Buffett and that part of the meeting has been recorded so I have not covered it in my notes. You can see it here. Munger talked more this year compared to previous years. I just love this man. He is brilliant! Following are my random notes from the meeting: Buffett does two things in his job- 1) keep operating managers happy
Read more

Systems Thinking as taught by Ackoff

-
One of my heroes is Dr. Russell Ackoff . I have read a few books he has written and have learned Systems Thinking from him. I am surprised that the field of Systems Thinking is not well understood. Following is my attempt to share what I learned from one of Ackoff's recent lectures. Albert Einstein once said, "You can't solve a problem with the same mind that created it." According to Dr. Russell Ackoff most managers agree with Einstein's statement but not many know what it means. It is easy to agree with something whose meaning is vague. In the Renaissance era, when the science as we know it today was born, a scientific inquiry method called Analysis was developed. Analysis comes naturally to us. Just watch kids breaking new things and being curious about the parts. The understanding of something follows a three step process in analytical thinking: 1. Take it apart 2. Understand (function, role, behavior) what the parts do 3. Assemble the understanding of the pa
Read more