some minor improvements

Author: thomasWeise

README.md

@@ -23,7 +23,11 @@ The book itself can be downloaded as pdf at <https://thomasweise.github.io/progr
 ### 2.2. Die Slides in Deutsch &mdash; The Slides in German Language
 Die Slides zum Kurs in deutscher Sprache können unter <https://thomasweise.github.io/programmingWithPythonSlidesDE> gefunden werden und sind hier aufgelistet:
 
-1. [Einleitung](https://thomasweise.github.io/programmingWithPythonSlidesDE/01_einleitung.pdf)
+
+1. [Organisation](https://thomasweise.github.io/programmingWithPythonSlidesDE/01_organisation.pdf)
+2. [Einleitung](https://thomasweise.github.io/programmingWithPythonSlidesDE/02_einleitung.pdf)
+3. [Python Installieren](https://thomasweise.github.io/programmingWithPythonSlidesDE/03_python_installieren.pdf)
+4. [PyCharm Installieren](https://thomasweise.github.io/programmingWithPythonSlidesDE/04_pycharm_installieren.pdf)
 
 ### 2.3. The Slides in English
 The slides for the course are available at <https://thomasweise.github.io/programmingWithPythonSlides> and also listed below.

text/main/basics/gettingStarted/installingPyCharm/installingPyCharm.tex

@@ -1,12 +1,19 @@
 \hsection{Installing PyCharm}%
 \label{sec:installingPyCharm}%
 %
+\begin{figure}%
+\centering%
+\includegraphics[width=0.5\linewidth]{\currentDir/usingNotepadAsEditor.pdf}%
+\caption{We do not want to use the \textil{NotePad}\nobreakdashes-App of \microsoftWindows\ for programming, do we?}%
+\label{fig:usingNotepadAsEditor}%
+\end{figure}%
+%
 Just having a programming language and the corresponding interpreter on your system is not enough.
 Well, it is enough for just running \python\ programs.
 But it is not enough if you want to develop software efficiently.
 Are you going to write programs in a simple text editor like a caveperson?
 No, of course not, you need an \pgls{ide}, a program which allows you to do multiple of the necessary tasks involved in the software development process under one convenient user interface.
-For this book, I recommend using \pycharm, whose community edition is freely available.
+For this book, I recommend using \pycharm~\cite{VHN2023HOADWP,Y2022PPADT,W2024PME}, whose community edition is freely available.
 The installation guide for \pycharm\ can be found at \url{https://www.jetbrains.com/help/pycharm/installation-guide.html}.%
 %
 \hinput{installingPyCharmUbuntu}{installingPyCharmUbuntu}%

text/main/basics/gettingStarted/installingPyCharm/installingPyCharmUbuntu/installingPyCharmUbuntu.tex

@@ -43,14 +43,14 @@
 \label{fig:installingPyCharmUbuntu06launcher}%
 ]{\tightbox{\includegraphics[height=3.1cm]{\currentDir/installingPyCharmUbuntu06launcher}}}%
 %
-\hfill%
+\floatSep%
 %
 \subfloat[][%
 The \pycharm\ welcome screen appears.%
 \label{fig:installingPyCharmUbuntu07welcome}%
 ]{\tightbox{\includegraphics[height=3.1cm]{\currentDir/installingPyCharmUbuntu07welcome}}}%
 %
-\hfill%%
+\floatSep%
 %
 \subfloat[][%
 \pycharm\ has been started.%
@@ -65,7 +65,7 @@
 \pycharm\ is available as Snap package under \ubuntu\ \linux~\cite{C2025SD,J2024PCPCE}.
 The installation process is very easy and follows the steps illustrated in \cref{fig:installingPyCharmUbuntu}.
 First, you open a \pgls{terminal} by pressing \ubuntuTerminal.
-Then, enter the command \bashil{sudo snap install pycharm-community --classic} and hit return~(\cref{fig:installingPyCharmUbuntu01snapInstall}).
+Then, enter the command \bashil{sudo snap install pycharm-community --classic} and hit~\keys{\enter}~(\cref{fig:installingPyCharmUbuntu01snapInstall}).
 This installs the \pycharm\ software package and the necessary super user privileges are obtained via the pre-pended \pgls{sudo}, which will ask us to enter the root password, as sketched in \cref{fig:installingPyCharmUbuntu02sudo}.
 Then, the installation process basically runs automatically.
 Once it has completed (see \cref{fig:installingPyCharmUbuntu05snapInstallFinished}), you can press the \keys{\OSwin} key and type \bashil{pycharm} in the launcher window to find \pycharm~(\cref{fig:installingPyCharmUbuntu06launcher}).

text/main/basics/gettingStarted/installingPyCharm/installingPyCharmWindows/installingPyCharmWindows.tex

@@ -9,7 +9,7 @@
 \label{fig:installingPyCharmWindows01download}%
 ]{\tightbox{\includegraphics[width=0.47\linewidth]{\currentDir/installingPyCharmWindows01download}}}%
 %
-\hfill%
+\floatSep%
 %
 \subfloat[][%
 Downloading the \pycharm\ Community Edition.%
@@ -23,7 +23,7 @@
 \label{fig:installingPyCharmWindows03download}%
 ]{\tightbox{\includegraphics[width=0.47\linewidth]{\currentDir/installingPyCharmWindows03download}}}%
 %
-\hfill%
+\floatSep%
 %
 \subfloat[][%
 The download is starting.%
@@ -38,11 +38,11 @@
 \ContinuedFloat%
 %
 \subfloat[][%
-The download is completed. We click \keys{Open file}.%
+The download is completed. We click \menu{Open file}.%
 \label{fig:installingPyCharmWindows05runInstaller}%
 ]{\tightbox{\includegraphics[width=0.47\linewidth]{\currentDir/installingPyCharmWindows05runInstaller}}}%
 %
-\hfill%
+\floatSep%
 %
 \subfloat[][%
 The installer is starting.%
@@ -56,53 +56,52 @@
 \label{fig:installingPyCharmWindows07runInstaller}%
 ]{\tightbox{\includegraphics[height=3.75cm]{\currentDir/installingPyCharmWindows07runInstaller}}}%
 %
-\hfill\hfill%%
+\floatSep%%
 %
 \subfloat[][%
-We do want to install, so click \keys{Yes}.%
+We do want to install, so click \menu{Yes}.%
 \label{fig:installingPyCharmWindows08runInstaller}%
 ]{\tightbox{\includegraphics[height=3.75cm]{\currentDir/installingPyCharmWindows08runInstaller}}}%
-\hfill\strut%
 %
 \floatRowSep%
 %
 \subfloat[][%
-The welcome screen of the installer. We click \keys{Next}.%
+The welcome screen of the installer. We click \menu{Next}.%
 \label{fig:installingPyCharmWindows09installation}%
 ]{\tightbox{\includegraphics[height=4cm]{\currentDir/installingPyCharmWindows09installation}}}%
 %
-\hfill%
+\floatSep%
 %
 \subfloat[][%
-The installation folder selection. We click \keys{Next}.%
+The installation folder selection. We click \menu{Next}.%
 \label{fig:installingPyCharmWindows10installation}%
 ]{\tightbox{\includegraphics[height=4cm]{\currentDir/installingPyCharmWindows10installation}}}%
 %
-\hfill%
+\floatSep%
 %
 \subfloat[][%
-The installation options. We can click \keys{Next}.%
+The installation options. We can click \menu{Next}.%
 \label{fig:installingPyCharmWindows11installation}%
 ]{\tightbox{\includegraphics[height=4cm]{\currentDir/installingPyCharmWindows11installation}}}%
 %
 \floatRowSep%
 %
 \subfloat[][%
-The start menu folder choose dialog. We click \keys{Install}.%
+The start menu folder choose dialog. We click \menu{Install}.%
 \label{fig:installingPyCharmWindows12installation}%
 ]{\tightbox{\includegraphics[height=4cm]{\currentDir/installingPyCharmWindows12installation}}}%
 %
-\hfill%
+\floatSep%
 %
 \subfloat[][%
 The install process starts.%
 \label{fig:installingPyCharmWindows13installation}%
 ]{\tightbox{\includegraphics[height=4cm]{\currentDir/installingPyCharmWindows13installation}}}%
 %
-\hfill%
+\floatSep%
 %
 \subfloat[][%
-The installation is finished. Select ``Run PyCharm Community Edition'' and click \keys{Finish}.%
+The installation is finished. Select \inQuotes{Run PyCharm Community Edition} and click \menu{Finish}.%
 \label{fig:installingPyCharmWindows14installation}%
 ]{\tightbox{\includegraphics[height=4cm]{\currentDir/installingPyCharmWindows14installation}}}%
 %
@@ -115,7 +114,6 @@
 \ContinuedFloat%
 \centering%
 %
-\floatSep%
 \subfloat[][%
 The welcome screen of \pycharm.%
 \label{fig:installingPyCharmWindows15running}%
@@ -124,16 +122,14 @@
 \floatSep%%
 %
 \subfloat[][%
-We read the user agreement, confirm that we read it, and click \keys{Continue}.%
+We read the user agreement and -- if we want to agree -- confirm that we read it, and click \menu{Continue}.%
 \label{fig:installingPyCharmWindows16running}%
 ]{\tightbox{\includegraphics[width=0.4\linewidth]{\currentDir/installingPyCharmWindows16running}}}%
-\floatSep%
 %
 \floatRowSep%
 %
-\floatSep%
 \subfloat[][%
-We do not want to send any data and click \keys{Don't Send}.%
+We do not want to send any data and click \menu{Don't Send}.%
 \label{fig:installingPyCharmWindows17running}%
 ]{\tightbox{\includegraphics[width=0.4\linewidth]{\currentDir/installingPyCharmWindows17running}}}%
 %
@@ -143,7 +139,6 @@
 Finally, \pycharm\ is ready to use.%
 \label{fig:installingPyCharmWindows18running}%
 ]{\tightbox{\includegraphics[width=0.4\linewidth]{\currentDir/installingPyCharmWindows18running}}}%
-\floatSep%
 %
 \caption[]{The installation steps of \pycharm\ under \microsoftWindows~(continued).}%
 \label{fig:installingPyCharmWindowsC}%
@@ -153,9 +148,9 @@
 You first need to download the \pycharm\ Community Edition installation executable from \url{https://www.jetbrains.com/pycharm/download}.
 Make sure to download the Community Edition and nothing else, as shown in \cref{fig:installingPyCharmWindows01download,fig:installingPyCharmWindows02download,fig:installingPyCharmWindows03download}.
 Once the installer is downloaded, you start it and confirm that you wish to install \pycharm, as illustrated in \cref{fig:installingPyCharmWindows05runInstaller,fig:installingPyCharmWindows06runInstaller,fig:installingPyCharmWindows07runInstaller,fig:installingPyCharmWindows08runInstaller}.
-As \cref{fig:installingPyCharmWindows09installation,fig:installingPyCharmWindows10installation,fig:installingPyCharmWindows11installation} show, the installation setup process is more or less automated, we just need to click \keys{Next} here and there and finally click \keys{Install}~(\cref{fig:installingPyCharmWindows12installation}).
+As \cref{fig:installingPyCharmWindows09installation,fig:installingPyCharmWindows10installation,fig:installingPyCharmWindows11installation} show, the installation setup process is more or less automated, we just need to click \menu{Next} here and there and finally click \menu{Install}~(\cref{fig:installingPyCharmWindows12installation}).
 After the installation completes, we run \pycharm\ for the first time.
-Now we need to agree to the user agreement~(\cref{fig:installingPyCharmWindows16running}) and should probably choose that we do not with to send any information about our \pycharm\ usage out~(\cref{fig:installingPyCharmWindows17running}).
+Now we need to decide whether we want to agree to the user agreement~(\cref{fig:installingPyCharmWindows16running}) and may wish to choose that we do not want any information about our \pycharm\ usage being sent to anyone~(\cref{fig:installingPyCharmWindows17running}).
 Finally, as sketched in \cref{fig:installingPyCharmWindows18running}, we have a running and ready \pycharm\ \pgls{ide}.%
 %
 \FloatBarrier%