Commit 34525353e891e595ec802c3b38a06b5063abcdc8

Authored by Melissa Wen
1 parent accfb9a5

[oss-2018] review results as a whole

Showing 1 changed file with 82 additions and 90 deletions   Show diff stats
icse2018/content/06-results.tex
@@ -31,11 +31,10 @@ the platform under development using its integrated software components Gitlab @@ -31,11 +31,10 @@ the platform under development using its integrated software components Gitlab
31 and Mailman 31 and Mailman
32 \end{itemize} & 32 \end{itemize} &
33 \begin{itemize} 33 \begin{itemize}
34 -\item Confidence in developed code;  
35 -\item Transparency and efficiency in communication;  
36 -\item Easier monitoring and  
37 -increase interactions between development team and public servants;  
38 -\item Organically documentation and records generation; 34 +\item Trusting developed code;
  35 +\item Communicating with transparency and efficiency;
  36 +\item Easier monitoring and increasing interactions between development team and public servants;
  37 +\item Producting organically documentation and records;
39 \end{itemize} \\ \hline 38 \end{itemize} \\ \hline
40 39
41 \textbf{Bring together government staff and development team} & 40 \textbf{Bring together government staff and development team} &
@@ -46,10 +45,10 @@ were discussed on Gitlab Issue Tracker. \item Only strategic decisions or @@ -46,10 +45,10 @@ were discussed on Gitlab Issue Tracker. \item Only strategic decisions or
46 bureaucratic issues involve board directors. \item Continuous Delivery 45 bureaucratic issues involve board directors. \item Continuous Delivery
47 \end{itemize} & 46 \end{itemize} &
48 \begin{itemize} 47 \begin{itemize}
49 -\item Reduce communication misunderstood and better meet expectations of both sides;  
50 -\item Improve understanding of collaborative development by MPOG staff and increase their confidence for collaborative projects with the university;  
51 -\item Aligning both side pace to execute project-related activities (Empathy between gov and academia side)  
52 -\item Improving translation from one development process to the other; 48 +\item Reducing communication misunderstood and better meeting expectations of both sides;
  49 +\item Overcoming the government bias regarding low productivity of collaboration with academia;
  50 +\item Aligning both activities execution pace;
  51 +\item Improving the translation of the process from one side to the other;
53 \end{itemize} \\ \hline 52 \end{itemize} \\ \hline
54 53
55 \textbf{Split development team into priority work fronts with IT market specialists} & 54 \textbf{Split development team into priority work fronts with IT market specialists} &
@@ -60,7 +59,7 @@ bureaucratic issues involve board directors. \item Continuous Delivery @@ -60,7 +59,7 @@ bureaucratic issues involve board directors. \item Continuous Delivery
60 \item The meta-coach role was also defined to coordinate tasks between teams. 59 \item The meta-coach role was also defined to coordinate tasks between teams.
61 \end{itemize} & 60 \end{itemize} &
62 \begin{itemize} 61 \begin{itemize}
63 -\item Helping conciliation of development processes and decision-making; 62 +\item Helping to reconciliate development processes and decision-making;
64 \item Creating support-points for students, senior developers, and gov staff; 63 \item Creating support-points for students, senior developers, and gov staff;
65 \item Transfering of knowledge from industry and FLOSS community to both academia and government; 64 \item Transfering of knowledge from industry and FLOSS community to both academia and government;
66 \end{itemize}\\ \hline 65 \end{itemize}\\ \hline
@@ -79,46 +78,47 @@ communication interactions to the platform under development. In short, Wiki @@ -79,46 +78,47 @@ communication interactions to the platform under development. In short, Wiki
79 feature was used for meeting logging, defining goals, sprint planning, and 78 feature was used for meeting logging, defining goals, sprint planning, and
80 documentation of deployment processes and administration resources guide. Issue 79 documentation of deployment processes and administration resources guide. Issue
81 tracker was used for discussing requirements, monitoring the features under 80 tracker was used for discussing requirements, monitoring the features under
82 -development, registering changes, and validating functionalities delivered. The 81 +development, registering changes, and validating functionalities delivered. Finally, the
83 whole team used Mailing list to defining schedules of meetings and deliveries 82 whole team used Mailing list to defining schedules of meetings and deliveries
84 and also to collaborative definition of requirements. 83 and also to collaborative definition of requirements.
85 84
86 -Our surveys report a \textbf{transparency and efficiency in communication}.  
87 -Senior developers and students used mostly via Mailing list (100\%) and Issue  
88 -Tracker (62.5\%). Developers and MPOG staff interacted mostly via Mailing List  
89 -(87.5\%) and Issue tracker (50\%). For example, a MPOG IT analyst said that the  
90 -"communication goes far beyond that, you communicate to everyone in the project  
91 -everything that was happening. We did not use emails, we use the mailing list  
92 -more and avoid e-mails, it helped a lot because everything was public and did  
93 -not pollute our mailbox. You wanted to know something, could go there and look  
94 -at what was happening." 85 +Our surveys reports Mailing list (100\%) and Issue Tracker (62.5\%) as the main means
  86 +of interaction between senior developers and undergraduates. Developers and MPOG
  87 +staff also interacted mostly via Mailing List (87.5\%) and Issue tracker (50\%).
  88 +According to research findings, this movement made \textbf{communication more
  89 +transparent and efficient}. A MPOG IT analyst said that the
  90 +\textit{"Communicating well goes far beyond the speed, it is someone being able
  91 +to communicate to everyone everything that is happening in the project. We did
  92 +not use emails. We use more mailing list and avoid e-mails. It helped a lot
  93 +because everything was public and did not pollute our mailbox. You wanted to
  94 +know something, could go there and look at what was happening"}.
95 95
96 Migrating to SPB platform also provided an \textbf{easier monitoring and 96 Migrating to SPB platform also provided an \textbf{easier monitoring and
97 increase interactions between development team and public servants by 97 increase interactions between development team and public servants by
98 -coordinators}. As shown by collected data, 775 issues and 4,658 issue comments  
99 -was registered during the project in the main repository (without considering  
100 -the software repositories that integrated the platform) within the SPB  
101 -platform. The issues have 59 different authors (8 from MPOG staff), and  
102 -commented by 64 different users (9 form MPOG staff and users). Considering the  
103 -most active issues those that have 10 or more comments, in a set of 84 issues,  
104 -MPOG staff authored 36 issue (about 43\% of 84 issues with higher level of  
105 -interaction). An MPOG analyst highlighted that “there was a lot of evolution,  
106 -a lot of communication via Gitlab". This interaction also led MPOG staff to  
107 -\textbf{confidence in developed code}: "Everything was validated, we tested the  
108 -features and the project was developed inside the platform, so that the feature  
109 -was validated in the development of the software itself. [..] From the moment  
110 -we installed it, and began to use it for development, this validation was  
111 -constant. We felt confident about the features". 98 +coordinators}. As shown by collected data, in the last 15 months of the project,
  99 +775 issues and 4,658 issue comments was registered in the main repository
  100 +(without considering the software repositories that integrated the platform)
  101 +within the SPB platform. The issues have 59 different authors (8 from MPOG
  102 +staff), and commented by 64 different users (9 form MPOG staff and users).
  103 +Considering issues with higher level of interaction those that have 10 or more
  104 +comments, in a set of 84 issues, MPOG staff authored 36 issues (which represents
  105 +about 43\% of these most active issues). A MPOG analyst highlighted that
  106 +\textit{"there was a lot of evolution, a lot of communication via Gitlab"}.
  107 +This interaction also led MPOG staff to \textbf{trust developed code}:
  108 +\textit{"Everything was validated, we tested the features and the project was
  109 +developed inside the platform, so that the feature was validated in the
  110 +development of the software itself. From the moment we installed it, and
  111 +began to use it for development, this validation was constant. We felt confident
  112 +in the features"}.
112 113
113 One of the main concerns of traditional approach is meticulous documentation of 114 One of the main concerns of traditional approach is meticulous documentation of
114 -software and development steps. With this aforementioned practice, we could  
115 -meet this government demand without bureaucracies and changes in our  
116 -development process, generating \textbf{organically documentation and records  
117 -generation} in the platform itself, as one of the MPOG response evidenced: "For  
118 -me it was a lot of learning, there is a lot of things documented in the e-mails  
119 -and also there in the portal itself of what happened in the project. At any  
120 -moment we can go there and see how it worked, how the person did, and manages  
121 -to salvage those good points." 115 +the software designed and the development steps. With this aforementioned
  116 +decision, we could meet this government demand without bureaucracies and changes
  117 +in our development process, \textbf{producting organically documentation and
  118 +records} in the platform itself, as one of the MPOG response evidenced:
  119 +\textit{"For me, it was a lot of learning. There is a lot of things documented
  120 +in the e-mails and also in the portal itself. At any moment we can go there and
  121 +see how it worked, how someone did something. We can recover those good points"}.
122 122
123 \subsection{Bringing together government staff and development team} 123 \subsection{Bringing together government staff and development team}
124 124
@@ -126,82 +126,86 @@ The MPOG analysts observed communication noise in the dialogue between them and @@ -126,82 +126,86 @@ The MPOG analysts observed communication noise in the dialogue between them and
126 their superiors and in the dialogues with the development team that were 126 their superiors and in the dialogues with the development team that were
127 intermediated by the superiors. They said that direct dialogue with the 127 intermediated by the superiors. They said that direct dialogue with the
128 development team and biweekly visits to the university's lab \textbf{reduce 128 development team and biweekly visits to the university's lab \textbf{reduce
129 -communication misunderstood}. "At this point, the communication started to  
130 -change.. started to improve." According to one of the interviewees this new  
131 -dynamic unified the two sides: "I believe it was very positive, we also liked to 129 +communication misunderstood}. \textit{"At this point, the communication started to
  130 +change.. started to improve."} According to another interviewee, this new
  131 +dynamic unified the two sides: \textit{"I believe it was very positive, we also liked to
132 go there, to interact with the team. I think it brought more unity, more 132 go there, to interact with the team. I think it brought more unity, more
133 -integration into the project". The participation of the MPOG staff was also  
134 -considered positive by {72.9\%} of the students of them and to {81.1 \%} of them 133 +integration into the project"}. The participation of the MPOG staff was also
  134 +considered positive by {72.9\%} of the undegraduates and to {81.1\%} of them
135 think the presence of MPOG staff in sprint ceremonies was important for the 135 think the presence of MPOG staff in sprint ceremonies was important for the
136 -development. In addition, to \textbf{better meet expectations of both sides}  
137 -regarding the requirements developed, {75.6 \%} of students believe that writing 136 +development. In addition, to \textbf{better meet expectations of both sides}
  137 +regarding the requirements developed, {75.6\%} of students believe that writing
138 the requirements together with the MPOG staff was very important. According to 138 the requirements together with the MPOG staff was very important. According to
139 -one of them "Joint planning and timely meetings were very important for  
140 -understanding the needs of MPOG".  
141 -  
142 -One of the consequences of this direct government-academia interaction in  
143 -laboratory was empathy, as reported by one of the interviewees "You know people  
144 -in person and it makes such a big difference because it causes empathy. You  
145 -already know who that person is, it's not just a name". This subjectively helped  
146 -to \textbf{align both activities execution pace}. The teams' synchronization was  
147 -reinforced with the implementation of a Continuous Delivery pipeline. The  
148 -benefits of this approach were presented in our previous work \cite {?} and  
149 -corroborate these research results. To 81.1\% of students and 75\% of senior  
150 -developers, deploying new versions of the SPB portal in production was a  
151 -motivator during the project. 139 +one of them \textit{"Joint planning and timely meetings were very important for
  140 +understanding the needs of MPOG"}.
  141 +
  142 +An imported consequence of this direct government-academia interaction in
  143 +laboratory was empathy, as reported by one of the interviewees \textit{"You know
  144 +people in person and it makes such a big difference because it causes empathy.
  145 +You already know who that person is, it's not just a name"}. This subjectively helped
  146 +to \textbf{align both activities execution pace}, \textit{"When we went there,
  147 +we knew the people and we realized that, on our side, we also felt more
  148 +encouraged to validate faster and give faster feedback to the teams. They did
  149 +not stay there waiting. We gave this feedback fast and they also gave quick
  150 +feedback for any our questions. That gave project agility, things flowed faster
  151 +and better"}. The teams' synchronization was reinforced with the implementation
  152 +of a Continuous Delivery pipeline. The benefits of this approach were presented
  153 +in our previous work \cite {?} and corroborate these research results. To 81.1\%
  154 +of students and 75\% of senior developers, deploying new versions of the SPB
  155 +portal in production was a motivator during the project.
152 156
153 One of the MPOG analyst interviewed also noted these releases also helped to 157 One of the MPOG analyst interviewed also noted these releases also helped to
154 \textbf{overcome the government bias regarding low productivity of collaborative 158 \textbf{overcome the government bias regarding low productivity of collaborative
155 -projects with academia}: At first, the government staff had a bias that 159 +projects with academia}: \textit{"At first, the government staff had a bias that
156 universities do not deliver. We overcame that bias in the course of the project. 160 universities do not deliver. We overcame that bias in the course of the project.
157 We deliver a lot and with quality. Today, I think if we had paid the same amount 161 We deliver a lot and with quality. Today, I think if we had paid the same amount
158 for a company, it would not have done what was delivered and with the quality 162 for a company, it would not have done what was delivered and with the quality
159 -that was delivered with the price that was paid. Additionally, the deployment 163 +that was delivered with the price that was paid."} Additionally, the deployment
160 in production of each new version also \textbf{improve the translation of the 164 in production of each new version also \textbf{improve the translation of the
161 -process from one side to the other}, as mentioned by MPOG analyst We had an 165 +process from one side to the other}, as mentioned by MPOG analyst \textit{"We had an
162 overview at the strategic level. When we went down to the technical level, plan 166 overview at the strategic level. When we went down to the technical level, plan
163 the release every four months was difficult. But in the end, I think this has 167 the release every four months was difficult. But in the end, I think this has
164 not been a problem. A project you are delivering, the results are going to 168 not been a problem. A project you are delivering, the results are going to
165 production, the code is quality, the team is qualified/capable and the project 169 production, the code is quality, the team is qualified/capable and the project
166 -is doing well, it does not impact as much in practice 170 +is doing well, it does not impact as much in practice"}.
167 171
168 \subsection{Split development team into priority work fronts with IT market 172 \subsection{Split development team into priority work fronts with IT market
169 specialists} 173 specialists}
170 174
171 -Four teams were defined to dedicated to the main development demands of the 175 +Four teams were formed to dedicated to the main development demands of the
172 portal: UX, DevOps, Colab and Noosfero. External developers with vast experience 176 portal: UX, DevOps, Colab and Noosfero. External developers with vast experience
173 in the SPB platform software components and professionals with experience in 177 in the SPB platform software components and professionals with experience in
174 front-end and UX were hired. These professionals also contributed to 178 front-end and UX were hired. These professionals also contributed to
175 disseminate practices adopted in the industry and in the free software 179 disseminate practices adopted in the industry and in the free software
176 communities to other project members. {87.5\%} of seniors agreed with the 180 communities to other project members. {87.5\%} of seniors agreed with the
177 project development process. For 62.5\% this process has a good similarity to 181 project development process. For 62.5\% this process has a good similarity to
178 -their previous experiences. Their experience helped to \textbf{reconcile development 182 +their previous experiences. Their experience \textbf{helped to reconcile development
179 processes and decision making}, as stated by one of the respondent developers 183 processes and decision making}, as stated by one of the respondent developers
180 -"I think my main contribution was to have balanced the relations between the  
181 -MPOG staff and the UnB team". {62.5\%} of senior developers believe they have 184 +\textit{"I think my main contribution was to have balanced the relations between the
  185 +MPOG staff and the UnB team"}. {62.5\%} of senior developers believe they have
182 collaborated in the relationship between the management and development 186 collaborated in the relationship between the management and development
183 processes of the two institutions and {62.5\%} asserted that helped MPOG 187 processes of the two institutions and {62.5\%} asserted that helped MPOG
184 staff to more clearly express their requests. {62.5\%} of them did not 188 staff to more clearly express their requests. {62.5\%} of them did not
185 understand MPOG's project management process and {50\%} believe their project 189 understand MPOG's project management process and {50\%} believe their project
186 productivity was affected by MPOG's project management process. For the 190 productivity was affected by MPOG's project management process. For the
187 -government, these professionals gave credibility to the development "You had 191 +government, these professionals gave credibility to the development \textit{"You had
188 the reviewers, who were the original developers of the software, that gave 192 the reviewers, who were the original developers of the software, that gave
189 -you confidence and confidence in the code." 193 +you confidence and confidence in the code."}
190 194
191 In addition, with these professionals was possible to \textbf{transferred 195 In addition, with these professionals was possible to \textbf{transferred
192 knowledge of industry and free software to government and academia}. Working 196 knowledge of industry and free software to government and academia}. Working
193 -with senior developers was important for all student-respondents during the 197 +with senior developers was important for all undergraduate-respondents during the
194 project. {91\%} of them also believe that working with professionals was 198 project. {91\%} of them also believe that working with professionals was
195 important for learning. {75\%} of senior developers believe that 'Working in 199 important for learning. {75\%} of senior developers believe that 'Working in
196 pairs with a senior' and 62.5\% that 'Participate in joint review tasks' were 200 pairs with a senior' and 62.5\% that 'Participate in joint review tasks' were
197 the tasks with the involvement of them that most contributed to the evolution 201 the tasks with the involvement of them that most contributed to the evolution
198 of students in the project. And, in guiding a students, {75\%} believe that 202 of students in the project. And, in guiding a students, {75\%} believe that
199 this knowledge was widespread among the others in the team. This acquisition 203 this knowledge was widespread among the others in the team. This acquisition
200 -of knowledge was also noted by the government, which stated "On the side of 204 +of knowledge was also noted by the government, which stated \textit{"On the side of
201 UnB, what we perceived was that the project was very big leap when the 205 UnB, what we perceived was that the project was very big leap when the
202 original software developers were hired in the case of Noosfero and Colab, 206 original software developers were hired in the case of Noosfero and Colab,
203 because they had a guide on how to develop things in the best way and were 207 because they had a guide on how to develop things in the best way and were
204 -able to solve non-trivial problems and quickly " 208 +able to solve non-trivial problems and quickly."}
205 209
206 The fronts also gained more autonomy to manage their activities. The role 210 The fronts also gained more autonomy to manage their activities. The role
207 of meta-coach was defined among the students, to coordinate the interactions 211 of meta-coach was defined among the students, to coordinate the interactions
@@ -210,21 +214,9 @@ of reference for the development process}. {89.1\%} of students said that the @@ -210,21 +214,9 @@ of reference for the development process}. {89.1\%} of students said that the
210 presence of the coach was essential to the running of Sprint, and for {87.5\%} 214 presence of the coach was essential to the running of Sprint, and for {87.5\%}
211 of senior developers coaches was essential for their interaction with the team. 215 of senior developers coaches was essential for their interaction with the team.
212 MPOG analysts saw coaches as facilitators for their activities and for 216 MPOG analysts saw coaches as facilitators for their activities and for
213 -communication with the development team. One of the interviewees said "I  
214 -interacted more with the project coordinator and team coaches.", " The reason 217 +communication with the development team. One of the interviewees said \textit{"I
  218 +interacted more with the project coordinator and team coaches"}, \textit{"The reason
215 for this was that the coaches were more likely to meet the requirements, to 219 for this was that the coaches were more likely to meet the requirements, to
216 ask questions about requirements, to understand some features. interaction with 220 ask questions about requirements, to understand some features. interaction with
217 leaders than with senior developers. Sometimes the coaches brought the question 221 leaders than with senior developers. Sometimes the coaches brought the question
218 -to the senior developers. "  
219 -  
220 -  
221 -%%* Filtrar a comunicação por níveis de maturidade/experiência e  
222 -%responsabilidades  
223 -%%MPOG: "Eu acho que esses pontos de conflito eram muito mais fáceis de lidar  
224 -%com a equipe do que com a própria coordenação. [..] Eu acho que tem uma  
225 -%diferença também de papel tem uma diferença de postura. Eu acho que a  
226 -%relação com a equipe, embora ela fosse saudável, eu acho que a equipe não  
227 -%tinha tanta autonomia quanto à coordenação tinha. Então talvez fosse mais  
228 -%difícil com a coordenação e não com a equipe, porque a equipe ela sabia o  
229 -%limite dela e a partir dali ela não agia mais, ela já convocava a  
230 -%coordenação para lidar (a gerência)." 222 +to the senior developers"}.