Merge pull request #160 from GreatTeacherOni/docs/sheets/jvk-blatt1

docs(sheets): Rephrasing of parts of jvk-blatt1
FIUS · Oct 4, 2023 · dbe0ec2 · dbe0ec2
2 parents 29f9b93 + 65cbd0e
commit dbe0ec2
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 13 deletions.
diff --git a/sheets/1/exercise-1.tex b/sheets/1/exercise-1.tex
@@ -6,10 +6,11 @@
 \begin{Infobox}[How-To: Wie bekomme ich des Projekt]
     \begin{enumerate}[label=\arabic*.]
 
-        \item Nachdem das Zip-File \jvkpackage heruntergeladen wurde, muss man es in einem geeigneten Ordner entpacken.\\
+        \item Nachdem das Zip-File "\jvkpackage"\ heruntergeladen wurde, muss man es in einem geeigneten Ordner entpacken.\\
         \textbf{Windows:} Entpacken funktioniert durch einen Rechtsklick auf die Datei und dann durch Klicken auf \fbox{Alle extrahieren...}$\to$\fbox{Extrahieren}.\\
         \textbf{Linux:} Am schnellsten entpackt man ein Zip-File über das Terminal mit dem Befehl:
-        \newline\hspace*{\fill}\texttt{\textgreater\ unzip \jvkpackage}\hspace*{\fill}\newline
+        \newline\hspace*{\fill}\texttt{\textgreater\ unzip jvk-<versionsnummer>.zip}\hspace*{\fill}\newline
+        \textit{Hinweis: <> symbolisiert Platzhalter. Bitte mit aktueller Versionsnummer ersetzen.}\newline
         \textbf{Apple:} Nachdem man das Zip-File im Finder offen hat, entpackt man es durch einen einfachen Doppelklick.
     \end{enumerate}
 \end{Infobox}

diff --git a/sheets/1/intro.tex b/sheets/1/intro.tex
@@ -3,24 +3,24 @@
 \begin{center}
 	Hallo und herzlich Willkommen zum diesjährigen Java Vorkurs!\\
 \end{center}
-Hier werden wir Dir gemeinsam eine Grundlage in der objektorientierten Programmiersprache \textit{Java} aufzubauen, so dass Du in dem Fach \textit{Programmieren und Softwareentwicklung} - kurz PSE - im kommenden Semester nicht ganz von 0 aus starten musst.\newline
-Falls Du bei der Bearbeitung des Blatts Fragen oder Probleme haben solltest, kannst Du Dich immer gerne bei den Tutoren melden oder einfach mal deinen Nachbar*in rechts oder links von Dir fragen.\newline
-Wir empfehlen die Aufgaben nicht nur \enquote{im Kopf} zu bearbeiten, sondern Dir Notizen auf einem Blatt Papier, auf deinem Laptop oder einer Datei auf einem USB-Stick/ in der Cloud zu machen. Erfahrungsgemäß bringt Dir das selber mehr und du kannst deinen Mitstudenten ggf. mit deinen notierten Antworten schnell weiterhelfen oder mit ihnen diskutieren, wenn es Differenzen geben sollte.\\\\
+Hier werden wir mit dir gemeinsam eine Grundlage in der objektorientierten Programmiersprache \textit{Java} aufbauen, so dass Du in dem Fach \textit{Programmierung und Softwareentwicklung} - kurz PSE - im kommenden Semester nicht bei null beginnen musst.\newline
+Falls du bei der Bearbeitung des Blatts Fragen oder Probleme haben solltest, kannst du dich jederzeit gerne bei den Tutoren melden oder einfach mal deine Sitznachbar*innen fragen.\newline
+Wir empfehlen die Aufgaben nicht nur \enquote{im Kopf} zu bearbeiten, sondern dir Notizen auf einem Blatt Papier, auf deinem Laptop oder einer Datei auf einem USB-Stick/ in der Cloud zu machen. Erfahrungsgemäß bringt dir das selber mehr und du kannst deinen Mitstudent*innen ggf. mit deinen notierten Antworten schnell weiterhelfen oder mit ihnen diskutieren, wenn es Differenzen geben sollte.\\\\
 \textbf{Voraussetzungen:}
 \begin{itemize}
 	\item Eine halbwegs aktuelle Version des \textit{Java Development Kits}\\
 	$\rightarrow$ \href{\jdkTutorial}{Hier} gehts zum Tutorial, welches bitte nur mit \textit{Kopfhörern} angeschaut wird
-	\item Eine funktionierende \textit{IDE}, zum Beispiel \textit{Eclipse}. \textit{Eclipse} Installation: \newline
-	$\rightarrow$ Wenn Du bei der Vorstellung des Installationsvorgangs durch die Tutoren nicht ganz mitgekommen sein solltest, schau dir (bitte mit Kopfhörern) unser \href{\eclipseTutorial}{Tutorial} an.\\
-	$\rightarrow$ Falls das nicht möglich sein oder bei der Installation Probleme auftreten sollten, kannst du dich auch gerne melden. Unsere Tutoren helfen Dir gerne weiter.
-	\item Die aktuelle Version der \texttt{\jvkpackage} Datei\\
-	$\rightarrow$ Den Link zum downloaden findest du \href{\jvkpackageurl}{hier}
+	\item Eine funktionierende \textit{IDE}, zum Beispiel \textit{Eclipse}. \newline \textit{Eclipse} Installation: \newline
+	$\rightarrow$ Wenn du bei der Vorstellung des Installationsvorgangs durch die Tutoren nicht ganz mitgekommen sein solltest, schau dir (bitte mit Kopfhörern) unser \href{\eclipseTutorial}{Tutorial} an.\\
+	$\rightarrow$ Falls das nicht möglich sein oder bei der Installation Probleme auftreten sollten, kannst du dich auch gerne melden. Unsere Tutoren helfen dir gerne weiter.
+	\item Die aktuelle Version der \texttt{"\jvkpackage"}-Datei\\
+	$\rightarrow$ Den Download-Link findest du \href{\jvkpackageurl}{hier}
 \end{itemize}
 \textbf{Lernziele:}
 \begin{itemize}
-	\item \ref{ex1}: Eine Einführung in dem Umgang mit der integrierten Entwicklungsumgebung Eclipse, den Import von Maven Projekten und den Ausführen dieser. Anschließend sollen erste, kleinere Code-Edits durchgeführt werden.
+	\item \ref{ex1}: Eine Einführung im Umgang mit der integrierten Entwicklungsumgebung Eclipse, den Import von Maven Projekten und dem Ausführen dieser. Anschließend sollen erste, kleinere Code-Edits durchgeführt werden.
 	\item \ref{ex2}: \textbf{Nachschlag-Werk:} Eine Sammlung von Begriffserklärungen mit vielen Beispielen.\\
 	$\rightarrow$ Auch für Aufgaben auf späteren Übungsblättern nützlich
-	\item \ref{ex3}: Eine kleine Aufgabe, um Dich in der UI unseres Games zurecht zu finden und um mit den bereitgestellten Funktionen umzugehen zu lernen.
+	\item \ref{ex3}: Eine kleine Aufgabe, um dich in der UI unseres Games zurecht zu finden und um zu lernen mit den bereitgestellten Funktionen umzugehen.
 \end{itemize}
-\newpage
+\newpage