Abstract:
A method of collaboratively developing software includes recording a plurality of developers&#39; tasks relating to a collection of software development files via software executing on a computer. The method further includes calculating a proximity score between a plurality of tasks based on the overlap of the developers&#39; activities via software executing on a computer. The method further includes selecting and capturing a group of task properties that along with the proximity score can be used to select a group of task pairings that require coordination. The method further includes notifying the developers assigned to the task pairings selected that they may need to coordinate their development efforts.

Description:
[0001]    This invention was made with government support under Contract No. CCF-0916891 and VOSS OCI-1221254 awarded by the National Science Foundation. The government has certain rights in the invention. 
     
    
     TECHNICAL FIELD 
       [0002]    The method described herein relates to the field of software development, more particularly, to the field of collaborative software development. 
       BACKGROUND 
       [0003]    Tight coordination is required among development team members in order to deliver a successful software system. Unfortunately, there are several problems inherent in software development projects that make such coordination difficult. Several software characteristics—scale, interdependence, and uncertainty—cause unavoidable coordination problems. 
         [0004]    Software systems are becoming increasingly large, thus making complexity and interdependencies between modules of software systems particularly significant characteristics. Often, projects involve millions of lines of code and the development cycle spans multiple years. The size of these projects makes it impossible for any one individual or even a small group of individuals to fully understand all details of the system being developed. When projects become large, it is necessary to divide the development work among several teams of developers. This can create efficiency by allowing teams to work in parallel. However, parallel streams of work must eventually be integrated, which introduces additional coordination needs. Moreover, developers are often separated by geographic, organizational or social boundaries, and these boundaries can create coordination barriers. 
         [0005]    Software that has been broken into small components to be developed independently by many teams or developers must eventually be integrated into one deliverable software system. There are often many dependencies between the various components. In order for the end system to function correctly, the components must work together properly. Integration of software must be very precise. Lack of coordination among developers working on dependent components can lead to integration problems. 
         [0006]    Software development work is subject to continuous change that causes many difficulties and produces ongoing coordination needs. Requirements can change over time due to changes in user needs, hardware changes or changing business needs. 
         [0007]    These characteristics are inherent in modern software projects and introduce coordination overhead. While steps can be taken to reduce this coordination overhead, the need to coordinate cannot be completely eliminated in any project. Adding more people to project that is already behind schedule further delays the project due to the added project coordination and communication overhead. Coordination can be even more difficult when the involved developers span team boundaries. When cross-boundary dependencies exist, developers often do not coordinate due to a lack of awareness of the importance of the coordination as well as a lack of social relationships across teams. Lack of coordination results in integration problems. Coordination is one of the biggest problems in large software projects. Developers are not always aware of their coordination needs and when developers are unaware of the coordination that is required to manage their work dependencies, problems occur. Studies have found that unfulfilled coordination needs can result in an increase in task resolution time, an increase in software faults, build failures, redundant work, and schedule slips. 
         [0008]    Some researchers have developed methods of determining when individual coders should coordinate but the need to coordinate is only identified at the coder level. For example, coder A should coordinate with coder B. Since both coders A and B are usually involved in multiple tasks, this level of information is not actionable. The specific task-pair that they need to coordinate is the required information. 
         [0009]    Most software engineering work is done as “tasks.” Tasks are defined as a work assignment given to a specific coder. For example, a task may be to add a certain user requested function to the overall system, or it may be to fix an error that occurs when the system is used. Therefore, a task typically involves multiple files (or artifacts) of the overall system. The task may involve editing certain files, looking at certain files without editing (to make sure that the change in one file will not cause problems in others) or it may involve the creation of new files. 
         [0010]    To be actionable, coordination requirements must be identified at the task-pair level of detail. However, if every potential pair of tasks was identified as requiring coordination, information overload would prevent effective coordination. The example of the healthcare.gov website with its 500 million lines of code can shed some light on this potential information overload. Several thousand coders were/are involved in the development of this software system. The number of task-pairs that could potentially require coordination is in the multiple-billions. Therefore, in order to assure that the critical coordination requirement needs are identified, a means to identify those that are critical is required in real time. 
         [0011]    Awareness of coordination needs is a critical concern in large software projects. However, too many coordination requirements is the same as having no coordination requirements identified as the information overload causes the alerts to be ignored by software engineers. Thus, any coordination system should have high specificity as well as high sensitivity. 
         [0012]    There is a need in the art for a development coordination system that can identify dependencies and coordination needs with high specificity and sensitivity. 
         [0013]    Existing configuration management systems attempt to manage coordination requirements but they are limited in that they only manage direct conflicts. That is, the configuration management system will prevent two software engineers from working on the same file of code at the same time. Or, the configuration management system will allow parallel work on the same file and attempt to merge the changes when both engineers are completed their work. However, if code file X has a dependency on code file Y, the configuration management system will not be able to identify the need for engineers to coordinate their work when these files are simultaneously edited. 
       BRIEF SUMMARY 
       [0014]    A method of collaboratively developing software includes recording a plurality of developers&#39; task activities relating to a collection of software development files via software executing on a computer. The method further includes calculating a proximity score between a plurality of tasks based on the overlap of the developers&#39; activities via software executing on a computer. The method further includes identifying properties associated with each code file being worked on in a particular task. These task properties (such as software architectural properties, intended hardware host, operating system, etc.) are used along with the proximity score as input to an algorithm that selects the task parings that require coordination. The method further includes notifying the developers assigned to the task pairings selected that they need to coordinate development. 
         [0015]    In some embodiments, the developers&#39; activities include viewing and selecting files. 
         [0016]    In some embodiments, the method further includes: collecting information about software architecture, operating system, or hardware; selecting a group of task pairings based on the information collected; and selecting developers to be notified based on the groups selected. In some embodiments, other characteristics of the software files involved in a specific task may be collected to further refine the sensitivity of the coordination requirements between different task pairs. 
         [0017]    In some embodiments, the method further includes: querying the plurality of developers&#39; task related information on which entities require collaborating and the degree to that collaboration; selecting a group of task pairings based on the information collected. This information is then used to train a machine learning algorithm to differentiate between task parings that do or do not require coordination. In lieu of querying the plurality of developers, software architects with historical knowledge of the software system to which the invention is being applied can develop the data required to train the algorithm. 
         [0018]    In some embodiments, the method further includes: collecting information about the software design specification requirements; selecting a group of task pairings based on the information collected; and selecting developers to be notified based on the groups selected. 
         [0019]    In some embodiments, the method further includes: collecting information about software architecture, operating system, hardware or software design specification requirements; selecting a group of task pairings based on the information collected; and selecting developers to be notified based on the groups selected. In some embodiments, other characteristics of the software files involved in a specific task may be collected to further refine the sensitivity of the coordination requirements between different task pairs. 
         [0020]    In some embodiments, the method further includes periodically repeating the method to iteratively improve efficacy of the method based on actual coordination requirements and patterns of code file characteristics. In some embodiments, the proximity score between two tasks is calculated based on the following weights: 1 if a common file was edited by developers conducting both tasks; 0.59 if a common file was viewed by developers conducting both tasks; and 0.79 if a common file was viewed by a developer conducting one task and edited by a developer conducting the other task. In some embodiments, the proximity score between two tasks is calculated by summing the weighted instances of common file viewing and/or editing between developers conducting different tasks. In some embodiments, the proximity score is adjusted by the overlap of code file characteristics. In some embodiments, the threshold is a proximity score equal to or greater than the mean +2 standard deviations. In some embodiments, the selection is based on a machine learning algorithm. 
     
    
     
       BRIEF DESCRIPTION OF THE DRAWINGS 
         [0021]      FIG. 1  is a block diagram of a method according to one embodiment of the present invention; 
           [0022]      FIG. 2  is a block diagram of the embodiment of  FIG. 1 ; and 
           [0023]      FIG. 3  is a block diagram of the embodiment of  FIG. 1 . 
       
    
    
     DETAILED DESCRIPTION 
       [0024]    The system and method described herein identify the “proximity” of each developer&#39;s specific tasks to the other developers&#39; specific tasks to determine the extent and nature of their need to coordinate specific task pairings. A proximity score is calculated using the numbers of selects and edits that various users have made to the software development files and the software architectural and design requirement characteristics of the involved software development files. 
         [0025]    Proximity is a metric for measuring coordination needs in software development teams. Unlike more traditional coordination requirement detection techniques, it does not obtain information from the source control repository system (sometimes referred to as configuration management systems). These differences make proximity timely and turn coordination requirements into an actionable concept for managing coordination in software projects. 
         [0026]    To determine coordination requirements, the proximity algorithm examines the similarity of artifact (code files) working sets as they are constructed during developers&#39; tasks. To do this, it obtains developer actions such as artifact consultation or edits as they occur. At the same time artifact consultations are captured, the characteristics associated with the code files are also captured. To fulfill its own purposes, it records developer activities as they occur. These events are stored as context data for the task in focus. 
         [0027]    The proximity measure looks at artifact consultation and modification activities captured and weighs the overlap that exists between the working sets associated with other tasks of all developers working on the involved software system. It considers all actions recorded for each artifact in each working set in order to apply a numeric weight to that artifact&#39;s proximity contribution. Weights are applied based on the type of overlap where the most weight is given when an artifact is edited in both working sets (weight =1) and the least amount of weight is given when an artifact is simply consulted in both working sets (weight =0.59). When an artifact is edited in one working set and consulted in the other working set, we consider this a mixed overlap (weight =0.79). The calculation of proximity in this manner is referred to as the actual overlap between a specific task pairing. 
         [0028]    For each task paring, a maximum potential proximity score is also calculated. The maximum potential proximity score is the union of all files involved in the two tasks of a task pairing. Each file is assumed to have been edited in both tasks. Therefore, each file is given a sore of 1.0 and the maximum potential proximity score is therefore the count of all the files involved in the task pair. 
         [0029]    The proximity score for a specific task pair is then calculated as the ratio of the actual overlap versus the maximum potential overlap. Since this is a ratio, the proximity score for a given task pair must be equal to or less than 1.0. Higher proximity scores are indicative of a stronger need to coordinate. 
         [0030]    The system enables coordination of all critical conflicts by proactively monitoring the activities of each individual coder as they perform their tasks and comparing the activities of one coder&#39;s specific task against the activities of all other coders&#39; specific tasks (proximity scoring). In addition, the architectural features of the software system and the software design specification requirements are also leveraged to determine coordination requirements. 
         [0031]    Although configuration management systems focus on files, most software engineering work is done as “tasks.” Tasks are defined as a work assignment given to a specific coder. For example, a task may be to add a certain user requested function to the overall system, or it may be to fix an error that occurs when the system is used. Therefore, a task typically involves multiple files of the overall system. The task may involve editing certain files, looking at certain files without editing (to make sure that the change in one file will not cause problems in others) or it may involve the creation of new files. 
         [0032]    Upon completion of work, coders “commit” their changes (the new and/or edited files) in the configuration management system and when enough of the system (or sub-system) is sufficiently complete, the “integrated” modules are tested in what is known as an integration test. If coordination requirements were missed during the coding effort, errors are usually (but not always) found during the integration testing. If errors are found, rework that could have been avoided is required. If errors exist but are not detected during integration testing, the end user will eventually find the error. 
         [0033]    The development of software (coding) is performed using an “Integrated Development Environment” (IDE). IDEs include text editors that allow coders to view, write and or edit their individual files of software, to “unit test” their completed work, and to submit their completed work to the project&#39;s overall configuration management system. Some IDEs keep track of the coders&#39; activities at the task level. For example, metrics regarding which files are viewed and/or edited are available for each task a coder is working on. This information can be captured in real time to compare with the activities of other coders and used as an input to developing coordination requirements. 
         [0034]    In one embodiment of the system and method, the IDE is used to capture task level data on file edit and views. In another embodiment of the system and method, separate tracking of the software engineer&#39;s activities is performed by the system and method. 
         [0035]    The system described herein leverages all the known information regarding software engineering tasks so that real time critical coordination requirements can be identified. The identification of the critical coordination requirements at the task level makes the information generated by the system actionable. 
         [0036]    Unlike any system or research done to date, this system not only identifies direct conflict coordination requirements (working on the same software file) but it also determines indirect conflict (file X depends on file Y) coordination requirements at the task level of detail (by using file view metrics, software architectural properties, and software design specification requirements). And, it is done in a timely manner that makes the information actionable by the coders as they complete their tasks. Coordination requirements at the task level rather than at the developer level have never been predicted before. 
         [0037]    The system leverages information of the coders&#39; activities, the known properties of the files involved in the coders&#39; tasks, and machine learning to determine critical coordination requirements. The “known properties” can include; the hardware the software is running on, the operating system the software is running on, the software architecture itself, and the software design specification requirements. 
         [0038]    Even software systems that do not have an architecture diagram have a planned (or evolved) architecture. In cases where an architecture diagram is not available, there is usually an expert that understands the breakdown of the software modules and how work can be segregated to minimize overlap and coordination conflicts. This knowledge can be translated into a defined architecture diagram for use in executing the method. The system is intended for use on large scale software systems that could not be sustained without defined software architecture. 
         [0039]    In one embodiment of the method the software architecture is defined using a Design Rule Hierarchy (DRH) that identifies technical dependencies between software modules. Theoretically, independent software modules can be worked on in parallel without incurring coordination overhead. A DRH clusters modules into “layers” where each layer depends only on the layers above. The layers can be used to differentiate modules that represent influential design decisions (design rules) from low-level modules that depend on those decisions. The DRH establishes three categories of work that can be used to differentiate between tasks that can be completed independently and those that will require coordination:
       1. Same Layer Same Module (SLSM) pairs: Two tasks include edits to files that have a dependency and are in the same module. Tasks that have a SLSM relationship may require coordination.   2. Across Layer (AL) pairs: Two tasks include edits to files that have a dependency and are in different modules and different layers. Tasks that have an AL relationship may require coordination.   3. Same Layer Different Module (SLDM) pairs: Two tasks include edits to files that are in different modules of the same layer. By definition, there are no dependencies between these artifacts, so tasks with only SLDM relationships should be able to be completed independently.       
 
         [0043]    Software requirements are developed in many forms including but not limited to the following: system models; system design specifications; system performance specifications; technical requirements (performance, scale, reliability, security, integration); functional requirements specifications; business requirements; use cases; test cases; user interface requirements; bug reports; trouble tickets; and the like. 
         [0044]    Software requirements may be documented into discrete items within a large specification or into individual documents (i.e.: use cases and/or test cases) that are combined to form a composite requirements specification for the software system. Requirement specifications focus on both functional and technical requirements (e.g.: determining air speed is a functional requirement whereas calculating the air speed within a certain time-period using a limited allocation of the hardware&#39;s Central Processing Unit&#39;s (CPU) resources is a technical requirement). Requirements can be mission critical such as when various software elements are run on the same hardware of a jet airplane. For example, the software that controls 1) fuel flow, 2) the position of the wing flaps, and 3) the calculation of air speed, must all perform specific functions but do so within the technical requirements of time and CPU resource allocation. 
         [0045]    Technical and functional design requirements are normally grouped into specific areas. For example, in a health insurance software system, there are functional requirements pertaining to (1) member information such as name, address, date of birth, contact information, dependents, associated health plan, coverage dates, account activity; (2) health plan information such as services covered, deductibles, coinsurance and copay requirements; (3) provider information such as name, locations, provider contracts including fees for specific services, contract dates, etc. and (4) claims information which uses both the member, health plan and provider information to determine the remuneration the provider is to receive and the costs that the member must pay. Claim information becomes part of the members&#39; and providers&#39; account history so these design requirement functional areas may have overlapping requirements and a change in one portion of the software system may require collaboration with changes being made in another part. 
         [0046]    A software development team using the present invention may maintain maps (data repositories) that relate specific software files to the requirement specification item(s) that each software file satisfies either in whole or in part. A single software file may satisfy (either in whole or in part) one or more requirement specification items. The software-file-to-requirement-specification-mapping data repository can be leveraged to identify indirect conflicts in software development while development is being performed. For example, if one developer is working on a file that is part of a software requirement and another developer is working on a file that is part of the same software requirement, each of the developers may be notified that a collaboration may be necessary. 
         [0047]    The method captures the activities of all individual tasks in real time including the files each coder selects to either edit or to view for a particular task. The file view/edit information is then leveraged to collect the following task-pair properties (note; properties may vary for different software systems):
       Within same file   Within same platform   Within same operating system   Number of SLSMs   Number of ALs   Within same software requirement   Within same software requirement functional area   Within same software requirement technical area       
 
         [0056]    These properties are all known at the time work begins on each task and can be captured real time as work progresses. Therefore, by monitoring these metrics (or others that may better define a specific software system) critical potential coordination requirements can be identified in a timely manner. These potential coordination requirements can then be evaluated against a baseline set of “known parameters” to determine if the potential coordination requirement is sufficiently critical to alert the coders of the involved tasks requiring coordination. Thus, the coders are able to resolve the coordination requirement and prevent future rework or errors in the final software system. 
         [0057]    SVM Machine Learning: The properties decided upon for each software system are then used to create a baseline “region” of critical coordination requirements in a machine learning environment. This region is a multi-dimensioned space that correlates to the task-pair properties that define a task-pair as requiring or not requiring coordination. The system uses a Support Vector Machine (SVM) classification technique. 
         [0058]    An SVM is a supervised machine learning classification algorithm. Given a training set, it produces a model that can be used to predict the classification of unknown instances given a set of known parameters of those unknown instances. The known parameters are historical task-pair properties with known coordination requirements (discussed later as the “Ground Truth”). 
         [0059]    To perform parameter selection, the machine learning SVM uses the RBF (radial basis function) kernel. It estimates the accuracy of each combination of parameters through cross validation (CV). The parameter combination with the highest CV score is selected. This defines the region of critical coordination requirements that can be used to identify future task-pair combinations that have critical coordination requirements. It also establishes a region of non-critical coordination requirements. 
         [0060]    Ground Truth: Capturing historical records of task-pairs properties and identifying if each task-pair had (or did not have) critical coordination requirements defines the set of “known parameters.” A sample set of historical task-pairs is used to populate the machine learning SVM with “known parameters.” Software projects may have historical data available on coordination requirements that were found through manual processes. If such information exists, it can be used as the starting point for the Ground Truth and be updated/maintained with new data as the method is implemented and new data is automatically generated and reviewed by the software architecture team. 
         [0061]    The following process to establish Ground Truth is used in one embodiment:
       Each task-pair of an entire release of a software product is scored for potential coordination requirements. This scoring considers the overlap of common files between the involved tasks. If a common file was edited in both tasks, a score of 1 is added, if a common file was viewed in both files a score of 0.59 is added, and if a common file was edited in one task and viewed in the other task a score of 0.79 is added. Since a task-pair can have multiple files in common, each overlap of events for all files in common is added in a cumulative fashion.   Those task pairs with a score equal to or greater than the mean +2 standard deviations are selected.   The selected task-pairs are manually coded using the following Coding Guidelines and selected those that had “somewhat” or “very” average scores as critical requirements. The final selection assures that about half of the task-pairs required coordination. The number of task-pairs included in the final set of “ground truth” will depend on the size of the software system. As a minimum, approximately 300 task-pairs may be included in the final set of “ground truth.”       
 
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Characteristic 
                 No 
                 Somewhat 
                 Very 
               
               
                   
               
             
             
               
                 Task 
                 The 
                 The two task 
                 The two task 
               
               
                 Discussion 
                 discussions 
                 discussions refer to 
                 discussions refer 
               
               
                 Similarity: 
                 of the two 
                 common aspects of the 
                 to common 
               
               
                 Task 
                 tasks do 
                 system from the 
                 aspects of the 
               
               
                 discussions 
                 not share 
                 perspective of EITHER 
                 system from the 
               
               
                 often include 
                 any of the 
                 the user (system 
                 perspective 
               
               
                 details of the 
                 same 
                 features) or the system 
                 of BOTH 
               
               
                 task and any 
                 concepts. 
                 architecture (specific 
                 the user 
               
               
                 problems that 
                   
                 reference to code, 
                 (system features) 
               
               
                 have been 
                   
                 modules, etc.) 
                 and the system 
               
               
                 encountered. 
                   
                 OR 
                 architecture 
               
               
                 The coders to 
                   
                 The two task 
                 (specific 
               
               
                 rate the 
                   
                 discussions indicate that 
                 reference to 
               
               
                 similarity of the 
                   
                 the problems may be 
                 code, 
               
               
                 discussions 
                   
                 occurring in the same 
                 modules, etc.) 
               
               
                 occurring on 
                   
                 area of the code. 
                 The two task 
               
               
                 each task. 
                   
                   
                 discussions refer 
               
               
                   
                   
                   
                 to the same or 
               
               
                 Evidence of 
                 The 
                 The discussion in one of 
                 It is apparent 
               
               
                 Task Conflict: 
                 discussion 
                 the tasks does not 
                 based on the 
               
               
                 Task conflict is 
                 in the two 
                 explicitly mention a 
                 timing of the tasks 
               
               
                 the epitome of 
                 tasks does 
                 conflict between the two 
                 and the 
               
               
                 a coordination 
                 not seem to 
                 tasks. However, based 
                 discussion thread 
               
               
                 need and often 
                 indicate that 
                 on reviewing the timing 
                 that there was a 
               
               
                 indications of 
                 the two 
                 of the tasks and their 
                 conflict between 
               
               
                 conflicts exist 
                 tasks were 
                 discussions, it seems 
                 the pair of tasks. 
               
               
                 in the task 
                 conflicting in 
                 there may have been a 
                 The conflict is 
               
               
                 Discussions 
                 any way. 
                 conflict between the two 
                 clearly discussed 
               
               
                 (explicitly or 
                   
                 tasks that the team may 
                 and may or may 
               
               
                 implicitly). 
                   
                 not have been not aware 
                 not explicitly link 
               
               
                 The coders 
                   
                 of at the time. 
                 the two tasks by 
               
               
                 look for such 
                   
                   
                 ID. 
               
               
                 evidence. 
               
               
                   
               
             
          
         
       
     
         [0065]    The ground truth should be maintained on a periodic basis as the software evolves over time. The ground truth iteratively improves efficacy of by updating the algorithm based on actual results of the task pairing being identified as either false positives or false negatives. 
         [0066]    For new software development projects, the system should be initiated as soon as the software architecture diagram is developed and task-pair properties should be collected from the day coding begins. In the case of new projects, ground truth will eventually develop. The establishment of ground truth will be indicated by the precision and recall of the algorithm. 
         [0067]    Referring to  FIG. 2 , the dashed line is helpful for the software engineering life cycle, but it is not necessary for the method. 
         [0068]    Another way to view the method is to replace the cloud near the top right of  FIG. 1  with the process diagram in  FIG. 3 . This depicts how the method is integrated into the software development life cycle as part of the “Develop Code” activity. 
         [0069]    Although the invention has been described with reference to embodiments herein, those embodiments do not limit the invention. Modifications to those embodiments or other embodiments may fall within the scope of the invention.