Author Archives: Ajitesh Kumar
What is a Workflow?
While having a discussion with one of my colleagues, I found his interpretation of workflow quite interesting. There are myths around workflow. Many people relate workflow with software requirement requiring decision making such as approval/rejection etc. However, this is how workroom and workflow was described: As part of my daily activities, I may need to get into a workroom and see all that needs to be achieved on that day. Each of the tasks can be called as “output” that needs to be achieved. The “output” will require a set of input and, a set of activities to be performed in order to be achieved. The set of activities can …
How to Create Software Quality Metrics For Your Project
Well, if you are a software development partner for one or more of your customers, and you are looking forward for some of the following, you may want to adopt software quality metrics: Provide customers with software quality trending on various different software quality characteristic Monitor one or more projects for software quality What are various different things that you could measure for quantifying software quality? Defects Density (Functional Suitability): There are different data points you can use to measure defects density. Defects density can be defined to be one of the following: Number of defects divided by total lines of code written per sprint/release Number of defects divided by …
How to Write Good Doc Comments for a Class/Method?
Well, software engineers love to jump to the code (minus document) once design is completed. Majority of them do not write the help text around the class or methods. Some of them do write but they do not provide enough information. There are various reasons for the lack of enough comments within a class. Some of them are lack of time, lack of writing/articulation skills etc. Following are some of the questions which would you like to answer as part of comments for method or a class: Functionality: What does the class or the method do? You may want to provide information regarding the business requirement that the component fulfills. …
How to Write a Winner Design Document for Agile User Stories
When the development is based on agile methodology such as SCRUM and especially, distributed SCRUM, at some point, the need for design document becomes key to success of sprint delivery with as lesser technical debt as possible. In that regard, there has been questions around whether to have something such as design document at all. Many of those practicing agile as a developer just hate the idea of writing design documents and relate it with waterfall development model. They give the argument that a) in agile development, design have to change as we develop and b) thus, the design document may go obsolete in no time. To a great extent, I …
A Quick Way to Identify Code with Low Testability
Following is a quick way to identify code with low testability and hence low maintainability: Take any specific public method of the class Count for number of decision points such as following: – If – For – While – Switch – Inline ifs If the number of decision points in a method is more than 15 or so, it could be taken as indication that it may get difficult to write unit tests covering all possible flows. Thus, the code will have lower testability. The number of decision points in a method is also used to define/measure cyclomatic complexity of the method, or more specifically, McCabe Cyclomatic Complexity. Thus, mathematically …
5 Things to Consider while Gathering Requirements from your Customers
Most of the time, software engineers are primarily interested in understanding requirements only from functionality perspective or, more simply speaking, understanding the stated needs. However, many a times, the delighting experience is missed due to absence of one or more of following 5 software quality characteristics in software coding stage: Efficiency: This is also termed as “performance requirements” at the time of requirement analysis stage. This goes unspecified as customers are also not very much knowledgeable about how to specify efficiency requirements. Efficiency requirements include consideration of time and memory usage associated with the requirement. Security: Most of the times, software engineers are not very aware of various different security …
How to Write Re-usable Code
In my software quality sessions, one of my favorite questions had been “how to write re-usable code”. The most common answer has been following: Once one identified the re-usable components based on the functionality, once can write the components accordingly such that it can be reused. However, this argument required one to identify the reusable components at the design time. The question still remained. How would one write a code that can be termed as re-usable even if the component is not required to be reused at the moment? Another question that I ask is if it is possible to look at the code and say if this is a …
Top 5 Software Code Quality Concerns Your Customers May Have
If you want to delight your customer with great software code quality or avoid software code quality concerns of your customer, following are top 5 areas you may want to take care of: Functionality Suitability: Following are three different areas your software code should address: Correctness Completeness Appropriateness Out of above, correctness and completeness can directly be monitored and measured using bug tracking mechanisms. And, it is responsibility of both, developers and testers to make sure that these sub characteristics are complied. Developers achieve it by writing good unit tests, and test engineers achieve it by doing various different form of testing. From metrics perspectives, defect density is the area …
Software Quality Review – Scribe OAuth Library
Scribe OAuth Library helps you do quick OAuth based integration with some of the following web applications: Google Facebook Twitter LinkedIn and many more. You could find further details on following page on github. Following will present information on different perspectives: Structure Maintainability The duplication percentage isn’t very high. Duplication is one of the key criteria that reflects on the maintainability of the code. Higher the duplication, difficult is the code to maintain. Duplication is also considered as one of the code smells. Also, due to unavailability of unit tests in the source code bundle, I could not find the test coverage. Otherwise, test coverage depicts the testability of …
Different Kind of Architects
Are you one of them who get confused about what are different kind of architects? If yes, keep reading! Following are different kind of architects: Solution Architect: They are the people who architect business solutions to solve a set of business problems. They need to have in-depth knowledge about business in general. They also need to be very much aware of functioning of different strategic business units (SBU) in order to architect integrated solutions that may cut across different SBUs to solve the particular problem. They deal with business processes while working on the solution and a descriptive business process diagram is one of their key deliverables. They may be …
Test-Along Development (TAD): Unit testing technique
While talking to one of the client stakeholder, I came across this interesting term as Test-Along Development. Following are two different techniques I came across as common way of writing unit test: Test-driven development where we write unit tests first and then write enough code to make unit tests pass Write unit tests at the end once you are done with the development. Both of the above techniques presented enough challenges to the software developers. Some of them are following: Test-driven development: In agile development, in 2 week sprints, the design took much longer than 2-3 days. Thus, doing test-driven development was found to lead carry-overs for sprint given on …
They confuse between Module & Component
Ask software developers about what do they mean by a module and a component and, what is the difference between them? Ask them about how would they represent module or a component in their daily development activities? Most of the time the answer is quite confusing. Although they use these two words interchangeably, they remain confused on their actual meanings. Module can be defined as following: Represents a functionality Can be represented as a set of components Can have manifest file representing component configuration One or more modules make an application. Technically, a package can be termed as a module. There is something called as module oriented programming as well. …
How to Configure XDebug Debugger for Zend Studio
I have tried to configure many a times, Zend studio with XDebug due to various reasonss, most common being my computer getting crashed. And, everytime, I found myself reinventing the wheel after I got exhausted to figure out if I noted the configurations somewhere. This blog is for me to refer back whenever my laptop crashes again and I have to reconfigure Zend Studio, PHP and XDebug. Following entities will change: Downloading of XDebug DLL and placing the same in ext folder of php installation PHP INI file Zend Studio Debug Preferences Lets go over each one of them in detail: Download relevant XDebug dll from thos page. http://xdebug.org/download.php. The …
Software Quality Review: JActor
Overall Software Quality Rating: High (from Maintainability & Usability perspective) We reviewed JActor (http://sourceforge.net/projects/jactor/ ) in our software quality lab. Following is the overall structure of the software: The evaluation was done using manual and automated techniques. We were able to get findings related with following software quality characteristics: Maintainability: As per the available data, this has been measured in terms of duplications, and rules compliance. Ideally, test coverage would also have helped to determine the testability of the code. Our rating: High Maintainability Refer to the data below retrieved from Sonar code analysis: Note the duplications value of 0.4%. This is outstanding. Also, there were no blocker …
Multiple Classes with Single responsibility VS Single Class with Multiple Responsibilities
While taking a session with a set of mobile developers, one of them asked a question that made many of them curious. Why multiple classes when single class can do? The main reasoning for single class was that one would be able to save some lines of code. Also, one would be required to create just one object for multiple functionalities. Lets look at some of the key advantages of multiple classes, each one of them having single functionality. High in cohesion, and hence reduced coupling. This tends to make the class reusable. Lesser costly to change than single class. Following explains the cost structure related with a change: Let’s …
How to estimate effort for unit testing?
Is that a right question to ask at all during effort estimation stage? When taking workshop with software developers involved SCRUM methodology, I came across some of the following answers in relation with effort estimation vis-a-vis unit testing: No task was created for unit tests and hence, no effort was estimated. Thus, we didn’t write any unit tests. We had to deliver and we were running short of time; hence, we skipped unit testing? There are effort estimation done for functional tests by QA engineers; Then, why unit tests? Interestingly, some stakeholders on client end said about of software developers on offshore side not asking for tasks to be estimated …
I found it very helpful. However the differences are not too understandable for me