Managing Technical Debt Using VSTS

Introduction

Technical Debt is a term that is commonly used in agile-scrum team process. Technical debt is used for the work which team or an individual didn’t prioritize upon while pushing the deliverable, and either left some unwanted code in various project artifacts, such as - .cs, .config, .cshtml, .js, .sql etc. or didn't use the right technique to accomplish the goal. But, in real world software development process, this is expected and totally fine; as long as team takes the responsibility to pay off the Technical Debt.

How is Technical Debt created?

Technical Debt is like financial $$ debt; if you don’t pay off previously owned $ amount and keep borrowing more, then you are getting into messier situation. I assume that you are not the one who like debt that much, whether it is technical or financial. Anyway, just to be aware; if you don’t take good care of the following items, you are potentially seeding “Technical Debt” situation in general. Later on, that needs to be paid off.

• First and foremost, poor coding style and standards.
• No unit test cases.
• Not following the OO design principles.
• Developing long monolithic classes and code libraries.
• Not envisioning on proper candidate technology, architecture, or approach, and then hitting a wall. This means, when application is little bit mature, you start to feel the hit on user experience, performance, scalability, and code maintenance etc.
• Over engineered application, i. e., the things which can be done in simpler way, are done using very complicated mechanism. For instance, to encrypt the data, custom code is written or taken from internet, which causes a lot of security holes and performance hits.
• Code files have lot of comments, i.e., the code is completely documented. Many developers write few or no lines of comment for each line of code.
  
• Code is not self-documented, i.e., classes, functions, and variables etc., are given improper names. For example, a function is named Salary instead of EmployeeSalary, or a variable is called double sal instead of double employeeSalary.
  
• Shortcut approach is taken to push the functionality to meet the code completion deadlines. Such events trigger further refactoring to be performed later. For instance, you created one thick bulky Model class with a lot of classes within; Or hard coded various paths and endpoints into the .cs code rather than putting those into a web.config, and reading web.config Key in the code for the related value (key-value pair).
  
• Dead code in project. You must have seen or left some commented code in various code files. This is the dead code and needs to be cleaned up.

Based on the above mentioned points, now, you will be able to understand that why Technical Debt is also known as Code Debt or Design Debt. In addition to this, anything in your software development work which slows you down or looks odd or can be improvised, is a “Technical Debt”.

How to handle Technical Debt

The first step is, not to cause any technical debt from your end, if, at all, possible. However, in agile development, it’s common to have some technical debt accumulated over the period of time. If so, then move to second step. The second step is to report any technical debt which you have either caused or came across.

Please don’t get into blame game, or point finger to any individual. Let’s say, you come across some code blocks in a file you are working on, and then, you see some dead code. Rather than start cleaning it up, I recommend, you create a Technical Debt item and let the team decide.

How to Report Technical Debt

Technical debt items are usually reported as issues or as a “New Product Backlog Item”. Also, technical debt items are supposed to be logged in a separate backlog, i.e., don’t report those to Production or sprint backlog. In many teams, and as per my experience with agile-scrum, I have always worked on a separate dedicated “TechnicalDebt backlog”.

Having a separate Technical Debt Backlog allows the team to stay focused on Sprint backlog, and don’t interfere with business requirements which are logged in to the Product Backlog.

Creating Technical Debt backlog

Creation of backlog and modifying process templates etc. is usually done by an admin in your project team. In an agile team, setting this duty is usually performed by the scrum master.

If your team doesn’t already have a Technical Debt backlog, then it’s time create one.