clean up duplicates

Author: jcolomb

episodes/03-overview.md

@@ -28,15 +28,13 @@ This program will teach you best practices in data science project management an
 This material will help you to manage a research project that comprise some *online collaborative working*,
 has a relatively *big team, where people have complementary skills*,
 use *coding or programming*, as well as the *reuse of code*,
-and last but not least, aim at producing a *reproducible analysis*.
+and last but not least, aim at producing a *reproducible analysis*, as is pictured below.
 
-Here we give an short overview of the topics that will be covered in this course.
-Note that the course episode split follows a  different logic, and you will find training linked to each five of these data science specifics in most episodes.
-As pictured below, the specifics of data science projects can be grouped in five main topics: working online, working with a heterogenous and relative big team, writing code, reusing code, and aiming at a reproducible analysis.
-This latter point being central to data science practices. 
 
 <img src="../fig/datasciencespecifics.jpg" alt="Specicity of data science project. Five blocks (working online, large teams whose members have with specialised skills, writing code and re-using code) are placed around a central block where reproducible analysis is written. Data specifics by Julien Colomb CC-BY 4.0 " width="500"/>
 
+Here we give an short overview of the topics that will be covered in this course.
+Note that the course episode split follows a  different logic, and you will find training linked to each five of these data science specifics in most episodes.
 
 
 ## Online work
@@ -47,24 +45,22 @@ Discussions are also more difficult to organise and meetings are more complex to
 In this course, we will look at different elements that make this work easier.
 
 Af first, there should be one entry point for the project, where every team member can find the main documentation as well as links to other documents and data. 
-This starts with setting one `main` URL when setting up the project, as well as using good readme files and templates. The information needs to be updated during the project and shared with the whole team.
+This starts with setting `one main URL` when setting up the project, as well as using good readme files and templates. The information needs to be updated during the project and shared with the whole team.
 
 The use of online project management tool (like kaban boards for todo list) can also help members of the team to coordinate their work, and follow their achievements.
 
 ## Team science
 
-Because teams can be big, and quite heterogenous in terms of skills (especially computer and programming skills), it is important to follow best practice of team bulding.
+Because teams can be big, and quite heterogeneous in terms of skills (especially computer and programming skills), it is important to follow best practice of team building.
 
 In particular, one should set reasonable goals and milestones for the project, and document them in the main documentation.
 It is also important that every team member knows what his part is, and that the work is well distributed.
 
-One should make sure every team member is able to use the communication tools set for the team, and take particular care of the organisation of meetings. Data and code should be documented, such that every team member can follow and reuse the work of the other team members. 
-In this course, we will present ways to foster this documentation process.
-
+One should make sure every team member is able to use the communication tools set for the team, and take particular care of the organisation of meetings. Data and code should be documented (and this documentation work should be fostered), such that every team member can follow and reuse the work of the other team members. 
 
 ## Involves coding
 
-When data analysis is done via a programming language, things become mostly easier, but this facility has some drawbacks as well as some effects on data management practice.
+When data analysis is done via a programming language, things become mostly easier, but this facility has some drawbacks, as well as some effects on data management practice.
 
 First, a data analysis workflow will now start with the computer reading the raw data.
 This means that the choice of the data format for the raw data may change, and that manually gathered data should be (easily) computer readable. 
@@ -77,7 +73,7 @@ However, errors are easier to spot (doing code reviews and tests) and when the c
 
 ## Involves reuse of code
 
-Very soon in a research project, writing code consist mostly of taking code written by someone else and applying it (with some tweaks sometimes) to one own's data.
+Very soon in a research project, writing code consist mostly of taking code written by someone else and applying it (with some tweaks sometimes) to one own data.
 We will look at ways to find relevant code, make sure it can be trusted, make sure you can legally use it, and ways to cite it (to give recognition the initial software engineer deserves).
 
 In addition, code written in the project will probably be reused, too.
@@ -86,11 +82,11 @@ We will look into best practices to make this reuse easier, both in how the code
 
 ## Reproducibility
 
-At the core of data science, the analysis reproducibiliy is both a goal and a huge advantage (in terms of research transparency, trustworthiness and in term of work efficiency).
+At the core of data science, the analysis reproducibiliy is both a goal and a huge advantage (in terms of research transparency, trustworthiness and work efficiency).
 The use of code is not enough to get a reproducible analysis, one needs to have access to both the code and the data used to produce the research result, a concept called provenance.
 This may not be trivial, especially if several version of the code and of the data exist.
 
-In this course, we will have a strong emphasis on version control, while we will introduce the concepts (and some tools) of provenance, as well as literate programming (reproducible reports and executable papers).
+In this course, we will have a strong emphasis on version control, while we will introduce the concepts (and some tools) of provenance, as well as literate programming (reproducible reports and executable papers), where the code, the figure and explanatory text are bound in the same file.
 
 
 {% include links.md %}