Änderungsvorschläge von Raphael für Bereich "Lernende"

AdLerDokumentation/Writerside/topics/Design-Engine.md

@@ -1,3 +1,3 @@
 # Design
 
-Start typing here...
+Start typing here... [//]: # (TODO: RR: Inhalt fehlt noch?)

AdLerDokumentation/Writerside/topics/Lernende-BD.md

@@ -1,6 +1,6 @@
 # Lernende
 
-Willkommen auf der Benutzerdokumentation von AdLer Engine. <br>
-Wählen Sie den gewünschten Inhalt aus der Übersicht auf der linken Seite aus.
+Willkommen in der Benutzerdokumentation von AdLer Engine. [//]: # (TODO: RR: „von AdLer Engine“ klingt seltsam - „der“ wäre besser - ist „AdLer Engine“ überhaupt sinnvoll als Begriff den Nutzenden gegenüber? - entweder über Glossar-Verlinkung erklären oder so etwas wie „AdLer-Lernwelt“..?) <br>
+Wählen Sie den gewünschten Inhalt in Übersicht auf der linken Seite aus.
 
 <img src="imageManualEngine-LearningSpace-ViewOnStart.png">‚

AdLerDokumentation/Writerside/topics/Lernraum-Navigationsmenü.topic

@@ -6,7 +6,7 @@
        title="Lernraum - Navigationsmenü" id="Lernraum-Navigationsmenü">
 
     <chapter title="Produktbeschreibung" id="bezeichnung_produktteil">
-        <p>Im Lernraum-Navigationsmenü können aus einem <a href="ManualEngine-Lernraum-allgemein.topic">Lernraum</a> heraus andere Menüs aufgerufen, sowie der Ansichtsmodus gewechselt werden.</p>
+        <p>Im Lernraum-Navigationsmenü können aus einem <a href="ManualEngine-Lernraum-allgemein.topic">Lernraum</a> heraus andere Menüs aufgerufen, sowie der Ansichtsmodus gewechselt werden:</p>
         <img src="imageManualEngine_CalloutsLernraumNavigationsmenue.png" alt="240507_Callouts_Lernraum_Navigationsmenü.png"/>
         <table>
             <tr>
@@ -16,7 +16,7 @@
             </tr>
             <tr>
                 <td>1</td>
-                <td>Lernraum-Navigationsmenü-Button</td>
+                <td><control>Lernraum-Navigationsmenü</control>-Button</td>
                 <td>Öffnet/Schließt bei Klick das Lernraum-Navigationsmenü</td>
             </tr>
             <tr>
@@ -31,21 +31,21 @@
             </tr>
             <tr>
                 <td>4</td>
-                <td><control>Hauptmenü-Button</control></td>
+                <td><control>Startmenü</control>-Button</td>
                 <td>Öffnet bei Klick das <a href="ManualEngine_Startmenü.topic">Startmenü</a></td>
             </tr>
             <tr>
                 <td>5</td>
-                <td><control>Vollbild-Button</control></td>
-                <td>Wechselt bei Klick den Vollbildmodus der Ansicht</td>
+                <td><control>Vollbild</control>-Button</td>
+                <td>Wechselt bei Klick in den Vollbildmodus der Ansicht oder beendet diesen</td>
             </tr>
             <tr>
                 <td>6</td>
-                <td><control>Hilfe-Fenster</control>-Button</td>
+                <td><control>Hilfe-Menü</control>-Button</td>
                 <td>Öffnet bei Klick das <a href="ManualEngine-Hilfe-Menü.topic">Hilfe-Menü</a></td>
             </tr>
         </table>
-        <p>Auflistung/Verlinkung der zugehörigen Handlungsanweisungen</p>
+        <p>Auflistung/Verlinkung der zugehörigen Handlungsanweisungen:</p>
         <list>
             <li><a href="ManualEngine-Lernraum-wechseln.topic">Lernraum wechseln</a></li>
         </list>

AdLerDokumentation/Writerside/topics/ManualEngine-3D-Lernumgebung-bedienen.topic

@@ -5,5 +5,5 @@
        xsi:noNamespaceSchemaLocation="https://resources.jetbrains.com/writerside/1.0/topic.v2.xsd"
        title="Bedienung" id="ManualEngine-3D-Lernumgebung-bedienen">
 
-    <p>Start typing here...</p>
+    <p>Start typing here...</p> [//]: # (TODO: RR: Inhalte ergänzen?)
 </topic>

AdLerDokumentation/Writerside/topics/ManualEngine-Adaptivitätselement-bedienen.topic

@@ -7,14 +7,14 @@
 
     <procedure title="Adaptivitätselement abschließen" id="hier_steht_die_bezeichung_der_handlungsanweisung">
         <deflist type="compact" sorted="desc">
-            <def title="&#127937;">
+            <def title="&#127937; Ziel der Handlung">
                 <p>Ein <a href="ManualEngine-Lernraum-Adaptivitätselement.topic">Adaptivitätselement</a> öffnen und
                     erfolgreich abschließen.</p>
             </def>
         </deflist>
 
 
-        <step><p>Öffnen des Adaptivitätselements: Klicken Sie auf den Roboter in der 3D-Lernwelt um das
+        <step><p>Öffnen des Adaptivitätselements: Klicken Sie auf den Roboter in der 3D-Lernwelt, um das
             Adaptivitätselement zu öffnen.</p>
             <img src="imageManualEngine_Adaptivitaetselement_step01.png" alt="Adaptivitaetselement_Schritt1"/>
             <note>Ein Aufgabendialog öffnet sich, die Themeauswahl wird als Startseite angezeigt.</note>
@@ -29,11 +29,11 @@
         </step>
         <step><p>Auswählen der Schwierigkeit: Klicken Sie auf eine der bereitgestellten Schwierigkeitsstufen um
             fortzufahren.</p>
-            <tip>Fangen Sie mit den leichteren aufgaben an und steigern Sie den Schwierigkeitsgrad nach erfolgreichem
-                Beenden der aktuellen Aufgabe.
+            <tip>Fangen Sie mit den leichteren Aufgaben an und steigern Sie den Schwierigkeitsgrad, nachdem Sie die aktuelle Aufgabe erfolgreich
+                beenden haben.
             </tip>
             <img src="imageManualEngine_Adaptivitaetselement_step03.png" alt="Adaptivitaetselement_Schritt3"/>
-            <note>Im aufgabendialog wechselt die Seite von der Schwierigkeitsauswahl zur Aufgabe und den
+            <note>Im Aufgabendialog wechselt die Seite von der Schwierigkeitsauswahl zur Aufgabe und den
                 Antwortmöglichkeiten.
             </note>
         </step>
@@ -49,21 +49,21 @@
             </note>
             <note>
                 Sollte die Antwort falsch sein, versuchen Sie es erneut. Dazu klicken Sie auf den "Weiter"-Button und
-                wählen die selbe oder eine einfachere Schwierigkeit erneut aus.
+                wählen dieselbe oder eine einfachere Schwierigkeitsstufe aus.
                 <img src="imageManualEngine_Adaptivitaetselement_step05X.png"
                      alt="Adaptivitaetselement_Antwort_falsch"/>
             </note>
         </step>
         <step><p>Abschließen des Adaptivitätselemnts: Bearbeiten Sie alle erforderlichen Aufgaben und
-            Schwierigkeitsgrade. Nach Abschluss schlißen Sie den Dialog durch Klick auf den Schließen-Button (X).</p>
-            <tip>Ihren aktuellen Fortschritt können Sie in der Themenauswahl des Adaptivitätselemnts einsehen. Sollte
-                der Fortschritt 100% erreicht sein, gilt dieses als vollständig abgeschlossen.
+            Schwierigkeitsgrade. Nach Abschluss schließen Sie den Dialog durch Klick auf den Schließen-Button (X).</p>
+            <tip>Ihren aktuellen Fortschritt können Sie in der Themenauswahl des Adaptivitätselements einsehen. Sollte
+                der Fortschritt 100% erreicht sein, gilt dieses Element als vollständig abgeschlossen.
                 <img src="imageManualEngine_Adaptivitaetselement_step02.png" alt="Adaptivitaetselement_Schritt1"/></tip>
         </step>
         <note>
             <format style="bold">&#10004;
-                <p>Ein Adaptivitätselement wurde geöffnet, alle erforderlichen Aufgaben und Schwierigkeiten bearbeitet
-                    und durch Schließen des Aufgabendialoges diese erfolgreich abgeschlossen.</p>
+                <p>Ein Adaptivitätselement wurde geöffnet, alle erforderlichen Aufgaben und Schwierigkeitsstufen bearbeitet
+                    und durch Schließen des Aufgabendialoges wurde dieses Element erfolgreich abgeschlossen.</p>
                 <p>Die entsprechende Punktezahl wurde dem Lernfortschritt hinzugefügt. </p>
             </format>
         </note>

AdLerDokumentation/Writerside/topics/ManualEngine-Avatar-steuern.topic

@@ -7,14 +7,14 @@
 
     <procedure title="Avatar und Kamera steuern" id="hier_steht_die_bezeichung_der_handlungsanweisung">
         <deflist type="compact" sorted="desc">
-            <def title="&#127937;">
+            <def title="&#127937; Ziel der Handlung">
                 <p>Den Avatar im 3D-Lernraum bewegen.</p>
             </def>
         </deflist>
 
-        <p>Sie können Ihren Avatar im 3D-Lernraum bewegen, indem Sie auf mit der linken Maustaste oder per Touch-Eingabe
-            auf die gewünschte Zielstelle klicken. Alternativ können Sie auf ein Lernelement klicken, der Avatar bewegt
-            sich automatisch dorthin.</p>
+        <p>Sie können Ihren Avatar im 3D-Lernraum bewegen, indem Sie mit der linken Maustaste oder per Touch-Eingabe
+            auf die gewünschte Zielstelle klicken. Alternativ können Sie auch direkt auf ein Lernelement klicken, der Avatar bewegt
+            sich dann automatisch dorthin.</p>
         <img src="imageManualEngine_walking.png" alt="Avatar läuft zum Ziel" width="500"/>
 
         <deflist type="compact" sorted="desc">
@@ -26,7 +26,7 @@
         <p>Sie können die Kamera heran- und herauszoomen. Dazu nutzen Sie das Mausrad oder bei Toucheingabe die für das
             Zoomen gängige Geste.</p>
         <p>Sie können die Kamera bewegen. Dazu Halten Sie die rechte Maustaste gedrückt und bewegen dann die Kamera
-            durch Positionsänderung der Maus.</p>
+            durch Positionsänderung der Maus.</p> [//]: # (TODO: RR: Bei Touchbedienung nicht möglich? Sollte man darauf hinweisen?)
         <img src="imageManualEngine_zoom1.png" alt="Kamera herausgezoomt" width="500"/>
         <img src="imageManualEngine_zoom2.png" alt="Kamera herangezoomt" width="500"/>
 

AdLerDokumentation/Writerside/topics/ManualEngine-Bug-Report-senden.topic

@@ -7,13 +7,13 @@
 
     <procedure title="Bug-Report senden" id="hier_steht_die_bezeichung_der_handlungsanweisung">
         <deflist type="compact" sorted="desc">
-            <def title="&#127937;">
+            <def title="&#127937; Ziel der Handlung">
                 <p>Einen Bug-Report über Fehler in der AdLer 3D-Umgebung, dem Autorentool oder Moodle erstellen und senden.</p>
             </def>
         </deflist>
 
         <step>
-            <p>Öffnen Sie das <control>AdLer - Bug Report</control> Formular</p>
+            <p>Öffnen Sie das <control>AdLer-Bug-Report</control>-Formular.</p>
             <tip>
                 <p>Das Bug-Report-Formular kann durch folgende Möglichkeiten erreicht werden:</p>
                 <list>
@@ -23,7 +23,7 @@
             </tip>
         </step>
         <step>
-            <p>Optional: Falls Sie bereit sind Rückfragen zu erhalten und so der Fehlerbehebung beizutragen, geben Sie Ihre E-Mail-Adresse an.</p>
+            <p>Optional: Falls Sie bereit sind Rückfragen zu erhalten und so zur Fehlerbehebung beizutragen, geben Sie Ihre E-Mail-Adresse an.</p>
         </step>
         <step>
             <p>Erforderlich: Wählen Sie das betroffene System (AdLer 3D-Umgebung, Autorentool, Moodle) aus.</p>
@@ -59,12 +59,12 @@
             </tip>
         </step>
         <step>
-            <p>Optional: Geben Sie Informationen zur Umgebung an, auf dem der Fehler aufgetreten ist.</p>
+            <p>Optional: Geben Sie Informationen zur Umgebung an, in der der Fehler aufgetreten ist.</p>
             <tip>
                 <list>
                     <li>Gerätetyp (z.B. Laptop, Tablet)</li>
                     <li>Betriebssystem und Systemversion</li>
-                    <li>Browser und Browserversion, sowie installierte Addons (insbesondere Blocker aller Art)</li>
+                    <li>Browser und Browserversion, sowie installierte Addons (insbesondere "Blocker" aller Art)</li>
                     <li>angeschlossene/verwendete (Eingabe-)Geräte</li>
                 </list>
             </tip>

AdLerDokumentation/Writerside/topics/ManualEngine-Einfache-Lernelemente-abschließen.topic

@@ -7,7 +7,7 @@
 
     <procedure title="Einfache Elemente abschließen" id="hier_steht_die_bezeichung_der_handlungsanweisung">
         <deflist type="compact" sorted="desc">
-            <def title="&#127937;">
+            <def title="&#127937; Ziel der Handlung">
                 <p>Ein einfaches <a href="ManualEngine-Lernraum-Lernelement.topic">Lernelement</a> (Text, Bild, Video)
                     öffnen und schließen.</p>
             </def>

AdLerDokumentation/Writerside/topics/ManualEngine-H5P-Lernelemente-abschließen.topic

@@ -7,7 +7,7 @@
 
     <procedure title="H5P-Elemente abschließen" id="hier_steht_die_bezeichung_der_handlungsanweisung">
         <deflist type="compact" sorted="desc">
-            <def title="&#127937;">
+            <def title="&#127937; Ziel der Handlung">
                 <p><a href="H5P-GE.md">H5P-Elemente</a> öffnen und vollständig abschließen.</p>
             </def>
         </deflist>
@@ -17,7 +17,7 @@
             <img src="imageManualEngine_h5p_step01.png" alt="H5P_01" width="500"/>
             <note>Ein H5P-Fenster öffnet sich im Lernraum.</note>
         </step>
-        <step><p>H5P-Elemente bearbeiten: Befolgen Sie die angezeigten Anweisungen, meistens das Auswählen von Antworten
+        <step><p>H5P-Elemente bearbeiten: Befolgen Sie die angezeigten Anweisungen, etwa durch das Auswählen von Antworten
             und drücken eines Weiter-Buttons.</p>
             <tip>H5P-Lernelemente können aus verschiedenen Medientypen bestehen, bspw. Präsentationsfolien, Videos,
                 Audios, Online-Quellen, Zusammenfassungen, Multiple-/Single-Choice-Aufgaben, Lückentexte,
@@ -29,14 +29,14 @@
         </step>
         <step>
             <p>Einsehen der Ergebnisse: Am Ende jeder Aufgabe oder Aufgabenfolge können Sie Ihre Ergebnisse einsehen.
-                Sollten Sie Fehler gemacht haben können Sie die Aufgaben jederzeit wiederholen ("Retry"-Button) oder die
+                Sollten Sie Fehler gemacht haben, können Sie die Aufgaben jederzeit wiederholen ("Retry"-Button) oder die
                 Lösungen einsehen ("Show Solutions"-Button).</p>
             <img src="imageManualEngine_h5p_step05.png" alt="H5P_05" width="500"/>
             <warning>
                 <p>Zur Anrechnung der erzielten Punkte ist es zwingend erforderlich die Ergebnis-Seite (Summary)
                     aufzurufen, erst dann ist ein vollständiger Abschluss möglich.</p>
                 <p>Sollte keine Ergebnis-Seite im H5P-Lernelement eingebaut sein, ist diese auch nicht zum Abschluss
-                    erforderlich. Dies ist meist bei Elementen ohne Interaktion der Fall, wie bspw. dem Ansehen eines
+                    erforderlich. Dies ist meist bei Elementen ohne Interaktion der Fall, wie bspw. beim Ansehen eines
                     Dokumentes ohne Fragen.</p>
             </warning>
         </step>

AdLerDokumentation/Writerside/topics/ManualEngine-Hilfe-Menü.topic

@@ -6,7 +6,7 @@
        title="Hilfe-Menü" id="ManualEngine-Hilfe-Menü">
 
     <chapter title="Produktbeschreibung" id="bezeichnung_produktteil">
-        <p>Über das Hilfe-Menü können die AdLer Bedienungsanleitung aufgerufen und Fehler gemeldet werden.</p>
+        <p>Über das Hilfe-Menü können die AdLer-Bedienungsanleitung aufgerufen und Fehler gemeldet werden.</p>
         <note>Das Hilfe-Menü kann durch Klick auf den Fragezeichen-Button aufgerufen werden.
             <img src="imageManualEngine_HilfeMenueOeffnen.png" alt="Image Manual Engine Hilfe Menue Oeffnen" width="50"/>
         </note>
@@ -19,26 +19,26 @@
             </tr>
             <tr>
                 <td>1</td>
-                <td><control>AdLer Engine Bedienungsanleitung</control> Button</td>
-                <td>Öffnet bei Klick die AdLer Engine Bedienungsanleitung</td>
+                <td>Button <control>AdLer Engine Bedienungsanleitung</control></td>
+                <td>Öffnet bei Klick die AdLer-Engine-Bedienungsanleitung</td>
             </tr>
             <tr>
                 <td>2</td>
-                <td><control>Bug Report</control> Button</td>
+                <td>Button <control>Bug Report</control></td>
                 <td>Öffnet bei Klick das Bug-Report-Formular zum Melden von Fehlern</td>
             </tr>
             <tr>
                 <td>3</td>
-                <td><control>Log Export für Bug Report</control> Button</td>
+                <td>Button <control>Log Export für Bug Report</control> </td>
                 <td>Speichert bei Klick eine Log-Datei der AdLer-Session für den Bug-Report</td>
             </tr>
             <tr>
                 <td>2</td>
-                <td>Schließen Button</td>
+                <td><control>Schließen</control>-Button</td>
                 <td>Schließt bei Klick das Hilfe-Menü</td>
             </tr>
         </table>
-        <p>Auflistung/Verlinkung der zugehörigen Handlungsanweisungen</p>
+        <p>Auflistung/Verlinkung der zugehörigen Handlungsanweisungen:</p>
         <list>
             <li><a href="ManualEngine-Bug-Report-senden.topic"/></li>
         </list>

AdLerDokumentation/Writerside/topics/ManualEngine-In-3D-Lernumgebung-anmelden.topic

@@ -9,8 +9,8 @@
 
     <procedure title="Login" id="hier_steht_die_bezeichung_der_handlungsanweisung">
         <deflist type="compact" sorted="desc">
-            <def title="&#127937;">
-                <p>Als Nutzer in die 3D-Lernumgebung anmelden.</p>
+            <def title="&#127937; Ziel der Handlung">
+                <p>Als Nutzer in der 3D-Lernumgebung anmelden.</p>
             </def>
         </deflist>
 
@@ -42,7 +42,7 @@
                 neben den Eingabefeldern.
             </p>
             <tip>Sollte der Login nicht funktionieren, erscheint ein Hinweisfeld
-                <control>Login fehlgeschlagen. Bitte überprüfen sie Ihre Eingaben.</control>
+                <control>"Login fehlgeschlagen. Bitte überprüfen sie Ihre Eingaben."</control>
                 Überprüfen Sie Ihre Login-Eingaben und versuchen Sie es erneut.<img
                         src="imageManualEngine_startmenu_errorlogin_highlight.png" alt="Login fehlgeschlagen Warnung"/>
             </tip>

AdLerDokumentation/Writerside/topics/ManualEngine-Leistungsbeschreibung.topic

@@ -6,15 +6,15 @@
        title="Features auf einen Blick" id="ManualEngine-Leistungsbeschreibung">
     <chapter title="Produktbezeichnung" id="produktbezeichnung">
     <!--img src="" alt="Logo des Produkts"/-->
-    <p>Lernende können in einer ansprechenden 3D-Lernumgebung interaktiv durch Lehrende bereitgestellte Lernmaterialien spielerisch bearbeiten.
+    <p>Lernende können in einer ansprechenden, interaktiven 3D-Lernumgebung spielerisch Lernmaterialien bearbeiten, die durch Lehrende bereitgestellt wurden.
     So soll der Lernwille und die Motivation maßgeblich gesteigert werden.</p>
     <p>Kernfunktionalitäten des Produkts:</p>
     <list>
-        <li>Lernende werden durch immersive Lernwelten aktiviert, motiviert und erleben einen Flow</li>
+        <li>Lernende werden durch immersive Lernwelten aktiviert, motiviert und erleben einen "Flow"</li>
         <li>Lernende lernen individuell und flexibel</li>
         <li>Prinzipien des Game-based Learning</li>
         <li>Aufteilung des Lernerlebnisses in Lernwelten, Lernräume und Lernelemente mit individuellem Lernpfad</li>
-        <li>Nutzung der 3D-Lernwelt oder alternativ einer Moodle-Darstellung</li>
+        <li>Nutzung der 3D-Lernwelt oder alternativ einer zweidimensionalen Moodle-Darstellung</li>
         <li>Nutzung verschiedenster Lernelemente und Medien</li>
         <li>Klar definierte Lernziele</li>
         <li>Lernfortschritt jederzeit sichtbar</li>