Merge pull request #109 from elixir-europe-training/saad-patch-2

Saad patch 2

Author: saadarif

docs/chapters/chapter_05.md

@@ -4,21 +4,31 @@ Now that you have been introduced to:
 
 1. The importance of literate programming (LP)
 2. Using markdown to narrate your code
-3. Using Quarto to knit your code and narrative into a single LP document
+3. Using Quarto to knit your code and narrative into a single LP-compliant document
 
+It is time for a more comprehensive rounding-off exercise to bring it all together.
 
-It is time to back to our original script (#81: do we need to introduce this earlier?) and rework it into a full fledged literate programming document by applying our knowledge of markdown and quarto
-to transform the original script into an LP HTML or PDF document (Fig. 5.1).
+
+!!! question "Exercise"
+
+    Return to our original example of [non-LP script](https://github.com/clement-lee/coderep/blob/master/wisconsin.R)  (#81: do we need to introduce this in chapter?) and rework it into a full fledged literate programming 
+    document by applying uour knowledge of markdown and quarto to transform the original script into an LP HTML or PDF document (Fig. 5.1).
+
+    Specifically:
+    
+    1. Obtain the [Wisconsin.R](https://github.com/clement-lee/coderep/blob/master/wisconsin.R) script, copy the script into a new empty script in your RStudio environment  
+    2. Convert the script into a .Qmd or .Rmd document, with explanatory text and code chunks for plain code and plots
+    3. Knit your final .Qmd or .Rmd file to a PDF (or HTML) document 
+
+    ??? success "Solution"
+
+        There are no right or wrong answers here but certain solutions will definitely be better than others. if you get stuck or need inspiration check out one possible solution [here](https://github.com/clement-lee/coderep/blob/master/wisconsin.Rmd)
 
 <figure>
 <img src="../../assets/images/RtoQmdtoPDF.png" width="600"  alt="Image showing path from .R to .Rmd to .pdf"/>
 <figcaption> Figure 5.1 Going from the script (Winconsin.R) to a Qmd (or Rmd) file that can be knitted into a LP PDF or similar LP document. </figcaption>
 </figure>
 
 
-To complete this rounding off activity, you need to:  
-1. Obtain the [Wisconsin.R](https://github.com/clement-lee/coderep/blob/master/wisconsin.R) script, copy the script into a new empty script in your RStudio environment
-2. Convert the script into a .Qmd or .Rmd document, complete with explanatory narrative and appropriate code chunks for plain code and plots
-3. Knit your final .Qmd or .Rmd file to a PDF (or HTML) document and marvel and your wonderful LP-ified verison os the Wisconsin.R script 
 
-There are no right or wrong answers here but certain solutions will definitely be better than others. if you get stuck or need inspiration check out one possible solution [here](https://github.com/clement-lee/coderep/blob/master/wisconsin.Rmd)
+