$newline text

$# SPDX-FileCopyrightText: 2022 Felix Hamann <felix.hamann@campus.lmu.de>,Gregor Kleen <gregor.kleen@ifi.lmu.de>,Sarah Vaupel <vaupel.sarah@campus.lmu.de>,Steffen Jost <jost@tcs.ifi.lmu.de>,Winnie Ros <winnie.ros@campus.lmu.de>
$#
$# SPDX-License-Identifier: AGPL-3.0-or-later

<section>
  <h2 #courses>_{MsgInfoLecturerCourses}

  <dl .deflist>
    <dt .deflist__dt> Veranstaltungs-Bezeichner
    <dd .deflist__dd>
      <p>
        ^{newU2WFeat} Alle Veranstaltungen müssen ein Kürzel zur Identifikation besitzen,
        z.B. EiP, ProMo, SysPrak, etc.
      <p>
        Die Kombination aus Kürzel, Institut und Jahr muss eindeutig sein.<br />
        Eine Kursart, deren ausgewähltes Kürzel innerhalb des gewähltes Instituts und Jahres nicht eindeutig ist wird beim Versuch des Erstellens mit einer entsprechenden Fehlermeldung abgelehnt.
      <p>
        Empfehlungen für die Wahl eines Kursartkürzels:
        <ul>
          <li> Halten Sie das Kürzel möglichst kurz (maximal 10 Zeichen).
               Insbesondere abgeraten wird vom Gleichsetzen von Kursartkürzel und (vollem) Kursarttitel.
               Im Falle einer Überschreitung der empfohlenen Kürzellänge wird beim Erstellen eine entsprechende Warnung ausgegeben.
          <li> Vermeiden Sie Kennzeichner für das jeweilige Institut (z.B. "FA"), das Jahr (z.B. "2023") oder die Art eines Kurses in dessen Kürzel.
      <p>
        ^{plannedFeatInline} In Zukunft wird es möglich sein die Kategorie einer Kursart
        einzustellen (z.B. "Fahrlizenz" oder "Qualifikation (Sicherheit)").<br />
        Teinehmer:innen werden dann auch explizit nach Kursarten einer bestimmten Art
        suchen können.

    <dt .deflist__dt> Kursarten klonen
    <dd .deflist__dd>
      <p>
        Veranstalter:innen können <em>alle</em> Kursarten Ihres Instituts für das aktuelle Jahr klonen.

        Dabei werden vor allem Kursartkürzel und die Kursartbeschreibung übernommen;
        nicht jedoch Übungsblätter, Klausuren oder Anmeldungen.
      <p>
        Die Kursartbeschreibung kann in Html verfasst werden und
        <em>sollte die Modulbeschreibung enthalten!

    <dt .deflist__dt> Unterstützung für verschiedene Institute
    <dd .deflist__dd>
      <p>
        ^{newU2WFeat} Uni2work unterstüzt die Verwaltung von mehreren Instituten, d.h.
        Kursartnamen wie "[FA]" für Kursarten der Fahrerausbildung werden nicht mehr benötigt.
        Stattdessen gibt es nun Instituts-Filter für Kursartlisten.
      <p>
        Die Berechtigungen der FRADrive-Administrator:innen sind auf Kursarten des jeweiligen Instituts eingeschränkt,
        d.h. ein Administrator der Fahererausbildung kann keine Ergebnisse aus Kursen anderer Institute.

    <dt .deflist__dt> Materialzugriff
    <dd .deflist__dd>
      Der Zugriff auf Übungsblätter, Folien und andere Materialien
      kann von der Anmeldung zur Kursart abhängig gemacht werden.

    <dt .deflist__dt> Materialien veröffentlichen
    <dd .deflist__dd>
      Folien, Code-Bündel, usw. können bequem
      per Uni2work an die Teilnehmer verteilt werden, ggf. auch geschützt.

    <dt .deflist__dt> Kursart-Passwort
    <dd .deflist__dd> ^{newU2WFeat} Die Anmeldung zur Kursart kann durch ein Passwort geschützt werden.

    <dt .deflist__dt> Kursart-Veranstalter:innen und Kursart-Assistent:innen
    <dd .deflist__dd>
      <p>
        Kursart-Veranstalter:innen dürfen <em>beliebige</em> Personen
        ebenfalls zu Veranstalter:innen der Kursart machen.

        ^{newU2WFeat} Innerhalb der Kursart haben alle Kursart-Veranstalter:innen die
        gleichen Befugnisse und können insbesondere auch die Liste der
        Veranstalter:innen dieser Kursart bearbeiten.

      <p>
        ^{newU2WFeat} In Uni2work gibt es die Rollen "Dozent:in"
        und "Assistent:in":
        Dozierende dürfen im Wesentlichen neue Kursarten erstellen.
        Die Dozierende Berechtigung wird nach Instituten unterschieden.

        Assistent:innen haben nur Zugriff auf eine spezielle Kursart,
        aber innerhalb dieser Kursart die gleichen Rechte wie die jeweiligen Dozierenden.

      <p>
        In UniWorX gab es die Rolle "Assistent:in",
        d.h. alle "Veranstalter:in" mussten auch "Dozent:in" sein;
        eine Unterscheidung nach Instituten gab es nicht.

    <dt .deflist__dt> Kursart Teilnehmer:innen
    <dd .deflist__dd>
      <p>
        Für die Teilnehmer:innen einer Kursart werden nun Studiengangsinformationen angezeigt.
        Studierende mit mehreren simultanen Studiengängen müssen bei der
        Kursanmeldung ein Hauptfach auswählen, was die Notenmeldung beschleunigen kann.

      <p>
        ^{probFeatInline} Im Normalfall entsprechen die
        Studiengangsinformationen dem aktuellen Stand, es kann jedoch in
        Einzelfällen passieren, dass veraltete Daten angezeigt werden.<br />
        Ohne Rücksprache mit dem Studierenden sollten also keine schwerwiegenden 
        Entscheidungen getroffen werden, wenn diese ausschließlich auf dessen 
        Studiengangsinformationen beruhen (z.B. Veto in einer Zentralanmeldung).

      <p>
        Falls anstatt eines Studienganges oder eines Studienabschlusses nur eine
        Nummer angzeigt wird, so hat Uni2work die Zuordnung dieser Schlüsselnummern
        leider noch nicht erlernt.<br />
        Dies muss leider sukzessive erfolgen, da wir von der Studentenkanzlei
        keine aktuelle und vollständige Schlüsselzuordnung bekommen können.<br />
        ^{probFeatInline} Es kann sein, dass ein "gröberer" Studiengang
        angezeigt wird, als tatsächlich studiert wird (z.B. Medieninformatik
        statt Mensch-Computer-Interaktion).

    <dt .deflist__dt> Aus Studierendensicht
    <dd .deflist__dd>
      <p>
        ^{newU2WFeat} UniWorX hatte spezielle Links "Aus Studierndennsicht", welche in Uni2work überflüssig geworden sind.
        Stattdessen kann man sich in Uni2work #
          <a href=@{AuthPredsR}>Berechtigungen hier temporär selbst entziehen
        . Um die eigene Veranstaltung aus Sicht eines Teilnehmers/einer Teilnehmerin zu sehen, deaktiviert man #
        die Berechtigungsprüfungen "_{MsgAuthTagLecturer}" und/oder "_{MsgAuthTagCorrector}"
  
    <dt .deflist__dt> Aktuelles
    <dd .deflist__dd>
      <p>
        ^{newFeat 2019 10 7} Es lassen sich direkt auf der Kursartübersichtsseite Neuigkeiten in Bezug
        auf die Veranstaltung publizieren ("Aktuelles").
      <p>
        In Zukunft sind ein RSS-Feed und E-Mail-Benachrichtigungen
        hierfür geplant.
  
    <dt .deflist__dt> Termine
    <dd .deflist__dd>
      <p>
        ^{newFeat 2019 10 9} Es lassen sich, direkt auf der Kursartübersichtsseite,
        Termine in Bezug auf die Veranstaltung auf der Übersichtsseite
        publizieren (z.B. Wöchentlicher Termin der Vorlesung, einmalige
        Klausureinsicht, ...)
      <p>
        In Zukunft sind E-Mail-Benachrichtigungen bei Änderungen an den Terminen geplant.

<section>
  <h2 #exercises>_{MsgInfoLecturerExercises}

  <dl .deflist>
    <dt .deflist__dt> Korrektor:innen
    <dd .deflist__dd>
      ^{newU2WFeat} Korrektor:innen und Korrekturweise werden ad hoc pro Übungsblatt vom Veranstalter/von der Veranstalterin festgelegt;
      es gibt keine Eintragung von Korrektor:innen in der Veranstaltungskonfiguration.<br />
      Um reinen Tutor:innen vorab Zugriff auf Lösungen zu gewähren, sollten diese
      als Korrektor:innen mit Korrekturanteil 0 eingetragen werden.

      Für ein neues Blatt werden die Einstellung des vorangegangenen
      Blattes automatisch vorgeschlagen.

    <dt .deflist__dt> Verteilung
    <dd .deflist__dd>
      Jeder Abgabe für ein Übungsblatt kann ein Korrektor:in zugewiesen werden.

      Eine automatische, möglichst faire, Zuteilung kann sowohl
      manuell als auch automatisch mit Ende des Abgabezeitraums
      ausgelöst werden.
    
      ^{newU2WFeat} Korrektor:innen können pro Blatt auch als Abwesend oder Entschuldigt
      markiert werden und bekommen dann keine Abgaben automatisch zugeteilt.

      Abwesende Korrektor:innen bekommen in späteren Blättern
      mehr Abgaben zugeteilt, entsprechend ihres
      Anteils am verpassten Blatt.

    <dt .deflist__dt> Dateien
    <dd .deflist__dd>
      ^{newU2WFeat} Ein einzelnes Übungsblatt kann aus mehreren Dateien beliebigen Typs
      für Angabe und Lösung bestehen.
      Im Gegensatz zu den bisher verpflichtenden Zip-Archiven
      können nun einzelne Dateien in einem Schritt verändert werden.

    <dt .deflist__dt> Lösungshinweise
    <dd .deflist__dd>
      Zusätzlich zu Aufgabe und Lösung können Hinweise ab einem
      Datum vor Ende des Abgabezeitraums freigeschaltet werden,
      z.B. Lösungen zu Präsenzaufgaben.

    <dt .deflist__dt> Sichtbarkeit
    <dd .deflist__dd>
      <p>
        Übungsblätter können bis zu einem Datum "Sichtbar ab" vor allen Teilnehmer:innen versteckt werden.
        Das kann nützlich sein, um Tutor:innen und Korrektor:innen ein provisorisches Übungsblatt verfügbar zu machen,
        dessen Bewertungsmodalitäten und Fristen sich noch ändern können.
      <p>
        Erst wenn das Blatt sichtbar wird, sehen die Teilnehmer:innen dieses in Ihrer Übersichtsliste.
        Alle Dateien zur Aufgabenstellung sind aber erst mit Beginn des Abgabezeitraums erhältlich,
        so wie bisher in UniWorX auch.

    <dt .deflist__dt> Zeitstempel
    <dd .deflist__dd>
      <p>
        Alle Dateien eines Übungsblattes sind mit einem
        für Teilnehmer:innen sichtbaren Zeitstempel versehen.
      <p>
        Eine visuelle Hervorhebung geänderter/neuer Dateien
        und entsprechende Benachrichtigungen sind geplant,
        aber noch nicht verfügbar.

    <dt .deflist__dt> Externe Abgaben
    <dd .deflist__dd>
      Externe Abgaben (z.B. Papierabgaben)
      können mit Pseudonymen verwaltet werden:
      <ul>
        <li>
          Übungsblatt mit Abgabe-Modus
          <i>Abgabe extern mit Pseudonym</i> anlegen
        <li>
          Studierende können sich auf
          der Seite des Übungsblattes ein
          Pseudonym generieren und ihre Abgabe
          damit markieren.
          <p>
            Für jedes Übungsblatt müssen sich die
            Studierenden ein neues Pseudonym
            erstellen, damit eine anonyme Korrektur
            gewährleistet werden kann.
            Dadurch wird aber noch keine Abgabe im System angelegt,
            da i.A. nicht alle Teilnehmer:innen, welche ein Pseudonym anfordern,
            auch tatsächlich abgeben.
        <li>
          <p>
            Korrektor:innen bekommen die externen Abgaben
            ausgehändigt.
            Anhand der Pseudonyme
            muss der Korrektor/die Korrektorin dann in Uni2work
            <a href="@{CorrectionsCreateR}">
              Abgaben anlegen
            , welche danach wie üblich korrigiert werden können.
          <p>
            Solche angelegten Abgaben werden bei der nächsten
            Verteilung von Übungsblättern dem jeweiligen 
            Korrektor/der jeweiligen Korrktorin zum Arbeitspensum angerechnet.

    <dt .deflist__dt #correction-files> Korrekturdateien
    <dd .deflist__dd>
      <p>
        Zugeteilte Korrektor:innen und Kursverwalter:innen haben die Möglichkeit einzelne oder auch Sammlungen von Abgaben als ZIP-Archiv herunterzuladen.

      <p>
        Es wird hierbei jeder Abgabe eine Bewertungsdatei beigelegt.
        
      <p>
        ^{newU2WFeat} Das Format der Bewertungsdatei ist primär
        <a href="https://yaml.org">YAML (Englisch)
        \ und somit maschinell einfach zu interpretieren und zu verändern.
      
      <p>
        Zusätzlich zum YAML-Teil besteht die Möglichkeit ans Ende der Datei einen Bewertungskommentar für die jeweiligen Studierenden anzuhängen.
        Alternativ (für maschinelle Bearbeitung) kann ein Feld
        <code>comment
        eingefügt werden, dass den Kommentar als String enthält.

      <p>
        YAML ist kompatibel zu
        <a href="https://www.json.org/json-de.html">JSON
        .
        Bewertungsdateien können also beim Upload durch äquivalente JSON-Dateien (mit den gleichen Feldnamen) ersetzt werden.

      <p>
        Genauer Name und Dateiendung der Bewertungsdateien ist unerheblich; Uni2work prüft nur ob eine valide Abgabennummer teil des Dateinamen ist.
  
<section>
  <h2 #tutorials>_{MsgInfoLecturerTutorials}

  <dl .deflist>
    <dt .deflist__dt> Termine
    <dd .deflist__dd>
      Tutorien können beliebig viele reguläre Termine haben, die sich wöchentlich wiederholen.
      <br />
      Zusätzlich können beliebig viele <i>Ausnahmen</i> angelegt werden.
      <br />
      Hierbei überschreibt eine Ausnahme, dass ein Termin nicht stattfindet, die reguläre Terminplanung. Man gibt dafür einen beliebigen Zeitpunkt innerhalb des regulären Termins an. Daraufhin werden <em>alle</em> regulären Termine als ausfallend markiert, welche den angegebenen Zeitpunkt enthalten.
      <br />
      Eine Ausnahme, dass ein Termin außerplanmäßig stattfindet, überschreibt wiederrum Ausnahmen, die Termine ausfallen lassen.
      <br />
      Dieses Verhalten kann genutzt werden um einzelne Termine zeitlich zu verschieben, indem der reguläre Termin ausfällt und stattdessen ein außerplanmäßiger mit versetzter Zeit stattfindet.

    <dt .deflist__dt> Tutor:innen
    <dd .deflist__dd>
      <p>
        Tutor:innen werden ad hoc pro Tutoriumsgruppe festgelegt.
        <br />
        Eine Tutoriumsgruppe kann beliebig viele Tutor:innen haben und ein Tutor kann beliebig viele Tutoriengruppen betreuen.

      <p>
        Tutor:innen haben Zugriff auf die Namen und Studiendaten ihrer Tutoriums-Teilnehmer:innen, können Mitteilungen an sie verschicken (analog zu Kursartmitteilungen) und Teilnehmer:innen aus ihrem Tutorium entfernen.

      <p>
        ^{newFeat 2019 10 14} Optional kann den Tutor:innen volle Kontrolle über
        ihre Tutorien überlassen werden (bis auf Löschen des Tutoriums), Tutor:innen
        können dann insbesondere eigenständig den regulären Raum und die Zeit
        ihres Tutoriums anpassen.

    <dt .deflist__dt> Anmeldung
    <dd .deflist__dd>
      <p>
        Studierenden können sich auf der Kursartseite selbst zu Tutorien anmelden.
        <br />
        Die Anmeldung erfolgt momentan noch auf <i>first come, first served</i>-Basis.
        <br />
        Eine vorherige Anmeldung zur Kursart ist Voraussetzung.
      <p>
        Die Anmeldung kann pro Tutoriumsgruppe zeitlich beschränkt werden.
      <p>
        Tutoriumsgruppen können mit einer <i>Registrierungs-Gruppe</i> versehen werden. 
        Es handelt sich hierbei um einen beliebig wählbaren Text, der ansonsten keine Bedeutung hat.
        <br />
        Studierenden wird die Anmeldung nur in <i>einem Tutorium pro Registrierungs-Gruppe</i> erlaubt.

        Leere Registrierungs-Gruppen (d.h. es wurde keine Registrierungs-Gruppe angegeben) zählen hierbei als verschieden.
      <p>
        Um die Anmeldung in beliebig viele Tutoriumsgruppen zuzulassen können alle Registrierungs-Gruppen leer gelassen werden.
    
    <dt .deflist__dt> ^{newFeat 2019 10 10} Nachmeldung
    <dt .deflist__dd>
      Kursverwalter:innen können über die Teilnehmerliste der Veranstaltung Kursartteilnehmer:innen in Tutorien einteilen.


<section>
  <h2 #exams>_{MsgInfoLecturerExams}
  <p>  Das Verwalten von Prüfungen im Allgemeinen sind bereits großteils implementiert und einsetzbar. ^{newU2WFeat} In Erweiterung zu UniWorX werden nun neben Klausuren auch allgemeinere Prüfungsformen unterstüzt, z.B. mündliche Prüfungen oder auch Projektabnahmen, bei denen die Teilnehmer:innen in kleineren Gruppen zu verschiedenen Zeitpunkten und in verschiedenen Räumen geprüft werden.

  <dl .deflist>
    <dt .deflist__dt> Anlegen/Editieren
    <dd .deflist__dd>
          Prüfungen können von KursverwalterInnen angelegt werden.
          Eine Vielzahl von optionalen Eigenschaften können sofort oder später angegeben werden,
          z.B. Sichtbarkeit und Anmeldezeitraum.

    <dt .deflist__dt> Termine/Räume
    <dd .deflist__dd>
          ^{newU2WFeat} Eine Prüfung kann in mehrere Termine/Räume unterteilt sein, welche jeweils einen eigenen Ort und Zeitraum besitzen. 
        <p>
          Im einfachsten Fall lassen sich damit Klausuren abbilden, welche gleichzeitig in verschiedenen Räumen stattfinden.
        <p>
          Es lassen sich aber auch zeitlich getrennte Prüfungen verwalten, wie z.B. mündliche Prüfungen bei Seminaren oder Praktika.
          Teilnehmer:innen wird eine übersichtliche Tabelle aller Termine/Räume angezeigt.

    <dt .deflist__dt> Anmeldungen
    <dd .deflist__dd>
          Teilnehmer:innen können sich zu sichtbaren Klausuren innerhalb des eingestellten
          Anmeldezeitraums anmelden.
          Die Teilnehmerlisten können online oder per CSV Export/Import bearbeitet werden.

    <dt .deflist__dt> ^{newFeat 2020 01 29} Prüfungszuteilung
    <dd .deflist__dd>
          Auf Wunsch kann Uni2work die Zuteilung der Teilnehmer:innen auf die Prüfungen (Räume bzw. Prüfungstermine)
          nach verschiedenen Kriterien wie Name oder Matrikelnummer vornehmen.

    <dt .deflist__dt> ^{plannedFeat} Korrekturen
    <dd .deflist__dd>
          <p>
             Einzelne Prüfungskorrekturen können derzeit noch nicht eingetragen werden.
             Die Realisierung sollte bald erfolgen.
          <p>
            Die Eintragung von Korrekturen wird immer pro Teilaufgabe erfolgen.
          <p>
            Optional werden Klausurkorrektor:innen angegeben werden können, die ab Durchführung der Klausur berechtigt sein werden, eigenständig Korrekturergebnisse einzutragen.
            Es kann das Recht, Ergebnisse einzutragen pro Korrektor:in auf bestimmte Teilaufgaben beschränkt werden können.
          
    <dt .deflist__dt> ^{newFeat 2019 9 25} Ergebnisse
    <dt .deflist__dd>
          <p>
            Die Berechnung der Prüfungsergebnisse kann automatisch durch Uni2work erfolgen. Dabei muss ein Notenschlüssel angegeben werden, an dem die Endnote der Studierenden automatisch anhand der erreichten Punktezahl abgelesen wird.
          <p>
            ^{newU2WFeat} Die automatisch abgelesenen Noten werden den Kursverwalter:innen dabei zunächst als Vorschlag angezeigt. Die Vorschläge müssen erst von einem Kursverwalter/einer Kursverwalterin akzeptiert werden, bevor sie als Ergebnisse den Teilnehmer:innen angezeigt und an die Prüfungsverwaltung gemeldet werden können.
          <p>
            ^{newU2WFeat} Die Vorschläge können auch unabhängig vom eingetragenen Notenschlüssel manuell überschrieben werden.

    <dt .deflist__dt> ^{newFeat 2019 9 26} Prüfungsbonus
    <dd .deflist__dd>
          Es gibt die Möglichkeit,
          die erzielten Bewertungen der Hausübungen
          unter einstellbaren Bedingungen
          in einen Prüfungsbonus umzurechnen (z.B. Anrechnung nur, falls bereits ohne Bonus bestanden).
          Dafür muss eine obere Schranke an erreichbaren Bonuspunkten für die Prüfung angegeben werden.
          Der Prüfungsbonus berechnet sich linear aus dem Anteil von erreichten Übungspunkten zur maximalen Bonuspunktezahl.

    <dt .deflist__dt> ^{plannedFeat} Türschilder
    <dd .deflist__dd>
          Das Drucken von passenden Türschildern "Bitte Ruhe!" mit den passenden Eckdaten der Klausur
          wird momentan noch nicht unterstüzt.

    <dt .deflist__dt> ^{newFeat 2019 9 16} Notenmeldung
    <dd .deflist__dd>
        <p>
          Endnoten können automatisiert an die Prüfungsverwaltung gemeldet werden.
        <p>
          Nach dem Abschließen einer Prüfung (durch einen Knopf über der Teilnehmerliste) werden alle mit den geprüften Teilnehmer:innen assoziierten Prüfungsverwalter darüber informiert, dass die Notengebung abgeschlossen ist.
        <p>
          ^{newU2WFeat} Hat ein Prüfungsverwalter/eine Kursverwalterin die Note eines Teilnehmers/einer Teilnehmerin zur Kenntnis genommen, erscheint ein Häkchen auf der Seite "Prüfungsleistungen". Falls auch nach längerer Zeit noch keine assoziierte Prüfungsverwaltung die Note eines Teilnehmers/einer Teilnehmerin zur Kenntnis genommen hat, so sollte ein Kursverwalter/eine Kursverwalterin der Notenmeldung für den betroffenen Teilnehmer/die betroffene Teilnehmerin nachgehen (z.B. durch Ausstellen eines Scheins).
        <p>
          ^{newU2WFeat} Dozierende dürfen nach der Übergabe an die Prüfungsverwaltung
          nachträgliche Änderungen an den Prüfungen vornehmen.
          Diejenigen Prüfungsverwalter:innen, die von der nachträglichen Änderung betroffen sind, erhalten
          hierüber automatisiert eine Benachrichtigung.

<section>
  <h2>Sonstiges
  <dl .deflist>

    <dt .deflist__dt> Wartung
    <dd .deflist__dd>
      Planmäßige Wartungen werden <i>ohne Ankündigung</i>
      immer um 2:00h nachts durchgeführt.
      Es wird daher empfohlen, keine kritischen Abgabefristen
      um oder kurz nach dieser Zeit einzustellen.