Download as
Browse Code »

Commit 4aa1e8a213cdb74fd8b282e3654b643117a90991

Authored by Paulo Meireles
1 parent 6d2c48b8
Exists in master and in 3 other branches oss_2018, oss_2018_siqueira, rework_case_study

[opensym] Minor improvements

Showing 2 changed files with 16 additions and 20 deletions   Show diff stats
opensym2017/content/04-researchdesign.tex
  Diff comments   View file @4aa1e8a
... ... @@ -7,9 +7,7 @@ empirical work process and the lessons learned. In the begins of the new SPB
7 7 Portal project, we had in mind 3 main challenges to overcome, as explained in
8 8 the following open questions.
9 9  
10   -\begin{description}
11   -
12   -\item [Q1:] \textit{Which strategy could be used to integrate several existing
  10 +\textbf{Q1:} \textit{Which strategy could be used to integrate several existing
13 11 FLOSS tools to promote the collaborative software development?}
14 12 %
15 13 Based on an extensive list of functional requirements defined by the Brazilian
... ... @@ -20,7 +18,7 @@ were fully aware that we would need to improve those systems in order to
20 18 provide the rest. We were also convinced that it would be impossible to provide
21 19 all of those requirements with a single tool.
22 20  
23   -\item [Q2:] \textit{How to involve students in real-world projects interacting with
  21 +\textbf{Q2:} \textit{How to involve students in real-world projects interacting with
24 22 real customers?}
25 23 %
26 24 Our team was mainly composed of software engineering undergraduate
... ... @@ -29,7 +27,7 @@ designers on the team, as well as with the team of technicians and
29 27 managers from the Brazilian Government, and the management team from
30 28 UnB. For the majority of the students, this was a first professional experience. We have define an approach to involve the undergraduate students in this project with a central role in our development process.
31 29  
32   -\item [Q3:] \textit{How to introduce the FLOSS collaborative and agile
  30 +\textbf{Q3:} \textit{How to introduce the FLOSS collaborative and agile
33 31 practices to governmental development process?}
34 32 %
35 33 The Brazilian government works based on a very traditional way regarding
... ... @@ -39,5 +37,3 @@ certain expectations about the development of project according to RUP
39 37 (Rational Unified Process) and PMBOK (Project Management Body of Knowledge)
40 38 approaches, what not match our work based on agile and FLOSS practices. We have
41 39 created strategies that would support different these organizational cultures.
42   -
43   -\end{description}
... ...
opensym2017/content/09-conclusion.tex
  Diff comments   View file @4aa1e8a
... ... @@ -11,7 +11,7 @@ possible to mitigate conflicts experienced in the development environment
11 11 and to conciliate governmental and academy cultures. To summarize our main contributions, we answered in this section the three open questions those guided this paper.
12 12  
13 13  
14   -\textbf{Q1 -- Which strategy could be used to integrate several existing
  14 +\textbf{Q1:} \textit{Which strategy could be used to integrate several existing
15 15 FLOSS tools to promote the collaborative software development?}
16 16 %
17 17 The SPB portal integrates more than 10 FLOSS tools and provides several features,
... ... @@ -25,7 +25,7 @@ were identified, specific teams were formed to work with each one of them
25 25 and each team was composed of students with different levels of skills and at
26 26 least one senior professional.
27 27  
28   -\textbf{Q2 -- How to involve students in real-world projects interacting with
  28 +\textbf{Q2:} \textit{How to involve students in real-world projects interacting with
29 29 real customers?}
30 30 %
31 31 In terms of mitigating conflicts, we tried to show that, as long as the
... ... @@ -48,7 +48,7 @@ After the end of the project, some students successfully
48 48 embraced opportunities in public and private sectors, within national borders
49 49 and abroad. Some other students went further and started their own companies.
50 50  
51   -\textbf{Q3 -- How to introduce the FLOSS collaborative and agile
  51 +\textbf{Q3:} \textit{How to introduce the FLOSS collaborative and agile
52 52 practices to governmental development process?}
53 53 With some adaptations, what we called the ``translation processes'', it is feasible
54 54 to conciliate agile methodologies and FLOSS practices to develop software to
... ... @@ -65,7 +65,7 @@ university.
65 65  
66 66 From the answers of our initial open questions, we can also highlighted six lessons learned to make easier to share our experience during the development of the new SPB Portal.
67 67  
68   -\textbf{L1 -- The participation of experienced professionals is crucial to
  68 +\textbf{L1:} \textit{The participation of experienced professionals is crucial to
69 69 the success of the project.}
70 70 One important factor for the students was the composition of the teams
71 71 with the participation of experienced professionals.
... ... @@ -80,7 +80,7 @@ are, in the end, the ones responsible for the project -- is crucial to
80 80 make sure students participation is conducted in a healthy way, and it is an
81 81 instance of leading by example.
82 82  
83   -\textbf{L2 -- A balanced relationship between academia and industry.}
  83 +\textbf{L2:} \textit{A balanced relationship between academia and industry.}
84 84 The experience of the SPB project led UnB to develop a work style which
85 85 proved to be appropriate for an educational environment that brings
86 86 academia and industry together.
... ... @@ -103,10 +103,10 @@ opportunities in public, private, national, and international
103 103 organizations, in addition to those students that
104 104 opened their own companies.
105 105  
106   -\textbf{L3 -- Managing different organizational cultures.}
  106 +\textbf{L3:} \textit{Managing different organizational cultures.}
107 107 In the beginning of the project, the Brazilian Government stakeholders
108 108 had certain expectations about the project development that, let's
109   -say, didn't exactly match our work style based on agile and FLOSS practices.
  109 +say, did not exactly match our work style based on agile and FLOSS practices.
110 110 %
111 111 We had to develop strategies that would support these different
112 112 organizational cultures. The
... ... @@ -116,7 +116,7 @@ create a translation process between our team and the MP managers who
116 116 managed the project on their side assuming a traditional waterfall
117 117 process.
118 118  
119   -\textbf{L4 -- Managing higher-level and lower-level goals separately.}
  119 +\textbf{L4:} \textit{Managing higher-level and lower-level goals separately.}
120 120 During the initial phase of the project, the MP team has brought
121 121 strategic discussions to technical/operational meetings that
122 122 were supposed to be about practical technical decisions.
... ... @@ -131,7 +131,7 @@ discussions caused confusion on both sides.
131 131 From the middle of the project we were able to keep those
132 132 concerns separated, what eased the work of everyone involved.
133 133  
134   -\textbf{L5 -- Living with ill-advised political decisions.}
  134 +\textbf{L5:} \textit{Living with ill-advised political decisions.}
135 135 At the initial phases of the project, by political and personal
136 136 motivation, the main stakeholders from the Brazilian government imposed
137 137 the use of Colab to guide the development of the new SPB platform. Our
... ... @@ -149,7 +149,7 @@ project and after our analysis on the decision made by the MP, we
149 149 understand that MP managers are capable of ignoring technical reasons
150 150 in favor of political decisions.
151 151  
152   -\textbf{L6 -- Consider sustainability from the beginning.}
  152 +\textbf{L6:} \textit{Consider sustainability from the beginning.}
153 153 In the process of deploying the SPB platform in the MP infrastructure we had
154 154 to interact with the MP technicians. We did several workshops, training
155 155 and a meticulous documentation describing all the required procedures to
... ... @@ -169,7 +169,7 @@ should have been more involved with the process so they could at least be
169 169 comfortable in managing the platform infrastructure.
170 170  
171 171  
172   -Ultimately, the SPB portal is available at \url{softwarepublico.gov.br}. All
  172 +Ultimately, the SPB portal is in production and its full
173 173 documentation, including detailed architecture and operation manuals are
174 174 also available\footnote{\url{https://softwarepublico.gov.br/doc/}}.
175 175 %
... ... @@ -182,8 +182,8 @@ participate in these projects.
182 182  
183 183 Future work should use data produced by the project to validate and evaluate
184 184 how the used FLOSS and Agile practices have impacted the students and the
185   -governmental development process. For this, we would conduce a \textit{postmortem}
186   -analysis using the project open data and a survey targeting the involved actors.
  185 +governmental development process. For this, we will conduce a \textit{postmortem}
  186 +analysis using the project open data and a survey targeting the involved stakeholders.
187 187  
188 188 %===========
189 189 % Conclusion
... ...