Commit 34525353e891e595ec802c3b38a06b5063abcdc8
1 parent
accfb9a5
Exists in
master
and in
3 other branches
[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"}. |