add lectures to the materials

Manifest.toml

@@ -918,10 +918,10 @@ uuid = "90014a1f-27ba-587c-ab20-58faa44d9150"
 version = "0.11.16"
 
 [[deps.Parsers]]
-deps = ["Dates", "SnoopPrecompile"]
+deps = ["Dates"]
-git-tree-sha1 = "cceb0257b662528ecdf0b4b4302eb00e767b38e7"
+git-tree-sha1 = "3d5bf43e3e8b412656404ed9466f1dcbf7c50269"
 uuid = "69de0a69-1ddd-5017-9359-2bf0b02dc9f0"
-version = "2.5.0"
+version = "2.4.0"
 
 [[deps.Pixman_jll]]
 deps = ["Artifacts", "JLLWrappers", "Libdl", "Pkg"]

README.md

@@ -9,6 +9,10 @@ Extras:
 * in the `/exercises` folder for each book chapter you can find 10 additional
   exercises with solutions (they are meant for self study and are not discussed
   in the book)
+* in the `/lectures` folder for each book chapter you can find a Jupyter
+  Notebook file with code from this chapter (note that the code is slightly
+  adjusted in comparison to code contained in .jl files in the root folder
+  to accomodate it for running in Jupyter Notebook).
 
 ## Setting up your environment
 

lectures/README.md

@@ -0,0 +1,74 @@
+# Julia for Data Analysis
+
+## Contents
+
+This folder contains Jupyter Notebooks with lecture templates to the book
+["Julia for Data Analysis"](https://www.manning.com/books/julia-for-data-analysis?utm_source=bkamins&utm_medium=affiliate&utm_campaign=book_kaminski2_julia_3_17_22)
+that is written by Bogumił Kamiński and is planned to be published in 2022
+by [Manning Publications Co.](https://www.manning.com/).
+
+The lecture tempates can be used as:
+* starting point for preparation of teaching materials by instructors giving
+  couses about data analysis using the Julia language.
+* An alternative for the readers of the book to .jl files located in the root
+  folder of this repository.
+
+The notebooks were prepared by [Bogumił Kamiński](https://github.com/bkamins)
+and [Daniel Kaszyński](https://www.linkedin.com/in/daniel-kaszy%C5%84ski-3a7807113/).
+
+The files containing lecture template have a naming convention
+`lectureDD.ipynb`, where `DD` is book chapter number for which the  were
+prepared.
+
+The differences from the codes presented in the book (the .jl files
+in the root folder) are:
+
+* code layout was changed (so it is not identical to code presented in the book);
+* some codes adjusted or omitted in comparison to the book version, to make the
+  presentation suitable for Jupyter Notebook format.
+
+## Running instructions
+
+The Jupyter Notebooks are stored in the *lectures* folder of the repository.
+Therefore they will automatically use the information from
+*Project.toml* and *Manifest.toml* files that are contained in the root
+folder of the repository to properly set up the working environment.
+
+However, before running Jupyter Notebooks you need to make sure that your
+environment is properly configured to run Julia in Jupyter.
+
+The notebooks were prepared under Julia 1.7, but they should work under newer
+Julia 1.x versions. In this case what you might need to do is change Jupyter
+Notebook kernel to the version of Julia that you have. In this case please
+make sure to run the following command in projects root folder before
+working with the notebooks:
+
+```
+julia --project -e "using Pkg; Pkg.instantiate()"
+```
+
+The simplest way to configure your environment is as follows:
+
+* Start Julia in a terminal using `julia` command in the folder containing the
+  lecture materials.
+* press <kbd>]</kbd> to switch to package manager mode.
+* Make sure you are in a home project environment. Your prompt should look as
+  `(@v1.8) pkg>`. If it is not then run the `activate` command. Then you will
+  switch to the home project environment. The reason why we do it is to avoid
+  adding IJulia.jl to the local project environment of the book (as it could
+  update some of the packages used in the book).
+* Install the [IJulia.jl package](https://github.com/JuliaLang/IJulia.jl) by
+  running command `add IJulia`.
+* Rress <kbd>Backspace</kbd> to leave package manager mode.
+* Run the command `using IJulia; notebook(dir=pwd())` that will start Jupyter
+  in the current Julia directory. This directory should be the folder
+  containing the lecture materials as we have started Julia in this folder. If
+  you are not in this folder then instead of passing `pwd()` write a path to
+  the folder where the lecture materials are located.
+
+---
+
+*Preparation of these exercises have been supported by the Polish National Agency for Academic Exchange under the Strategic Partnerships programme, grant number BPI/PST/2021/1/00069/U/00001.*
+
+![SGH & NAWA](logo.png)
+