CADOCS II Is a conversational agent designed to operate locally, accessible through an executable file, enabling the identification and management of community smells in software development communities on GitHub.
This repository hosts the modifications made to the original CADOCS repository, a tool used for Slack interactions.
The entire CADOCS tool is composed of three modules:
- CADOCS II (this repository): The desktop application
- CADOCS: it is the Slack App used to interact with users.
- CADOCS_NLU_Model link: it is the ML service used to interpret the users' intents.
- csDetector link: the augmented and wrapped version of csDetector, used in our tool to detect community smells and other socio-technical metrics. The links are referred to our modified versions of the tools.
The complete list of detectable community smells—through the use of csDetector—and the associated refactoring strategies.
| Community Smell | Description | Refactoring Strategies |
|---|---|---|
| Organizational Silo | Siloed areas of the community that do not communicate, except through one or two of their respective members. | Restructure the community, Create communication plan, Mentoring, Cohesion exercising, Monitoring, and Introducing a social-rewarding mechanism. |
| Black Cloud | Information overload due to lack of structured communications or cooperation governance. | Create communication plan, Restructure the community, and Introduce a Social sanctioning mechanism. |
| Radio Silence | One interposes herself into every formal interaction across more sub-communities with little flexibility to introduce other channels. | Restructure the community, Create communication plan, Mentoring, Cohesion exercising, Monitoring, and Introduce a Social sanctioning mechanism. |
| Prima Donnas | A team of people is unwilling to respect external changes from other team members due to inefficiently structured collaboration. | NA |
| Sharing Villainy | Cause of a lack of information exchange, team members share essential knowledge such as outdated, wrong and unconfirmed information. | NA |
| Organizational Skirmish | A misalignment between different expertise levels of individuals involved in the project leads to dropped productivity and affects the project's timeline and cost. | NA |
| Solution Defiance | The development community presents different levels of cultural and experience background, leading to the division of the community into similar subgroups with completely conflicting opinions. | NA |
| Truck Factor Smell | Risk of significant knowledge loss due to the turnover of developers resulting from the fact that project information and knowledge are concentrated in a minority of the developers. | NA |
| Unhealthy Interaction | Long delays in stakeholder communications cause slow, light and brief conversations and discussions. | NA |
| Toxic Communication | Toxic interactions and conflicting opinions among developers could push them to leave the project. | NA |
There are several ways to install the tool. We discuss them individually below.
-
Windows 10
-
Python 3.11.*
-
Clone the current repository on your system
-
The tool require some additional modules to be installed that are listed in the requirements.txt file
-
Run file ToolGui
-
Windows 10
-
Python 3.11.*
-
Clone the current repository on your system
-
In the repository find the toolGui.exe file which contains the tool ready to run without any installation
-
Run toolGui.exe .