Füge Einleitung zum Benutzerkonto in musdb hinzu

book.toml

@@ -20,7 +20,7 @@ level = 0
 [output.linkcheck]
 # Should we check links on the internet? Enabling this option adds a
 # non-negligible performance impact
-follow-web-links = false
+follow-web-links = true
 
 # Are we allowed to link to files outside of the book's root directory? This
 # may help prevent linking to sensitive files (e.g. "../../../../etc/shadow")

src/Einleitung/WerStehtDahinter.md

@@ -1,21 +1,25 @@
 Wer dahinter steht
 ==================
 
-Entscheidungen
---------------
-
 Grundsätzlich sind es die beteiligten Museen und ihre Verbände, die das
 Geschehen von museum-digital lenken. Jedes Museum ist für seine eigenen
 Beiträge (und Einträge) verantwortlich. Diese Beiträge gestaltet das
 Museum mit den entsprechenden Werkzeugen von museum-digital in der
-regionalen (oder thematischen) Version, der es zugeordnet ist. Jede
-regionale (oder thematische) Version von museum-digital hat andere
-Betreuer:innen -- zumeist sind dies die regionalen Museumsverbände oder
-Landesstellen für Museumsbetreuung. Die deutschlandweite Version von
-museum-digital entsteht aus den regionalen (und thematischen) Versionen
-(halb-) automatisch.
+regionalen (oder thematischen) Version, der es zugeordnet ist.
 
-![Die AG Digitalisierung trifft sich in Quedlinburg](../assets/chapter_1-2/agdib_quedlinburg_800.jpg)
+## Betreuer
+
+Jede regionale (oder thematische) Version von museum-digital hat andere
+Betreuer:innen - zumeist sind dies die regionalen Museumsverbände oder
+Landesstellen für Museumsbetreuung. [Eine Liste der für die verschiedenen
+deutschen Regionen zuständigen Betreuer](https://nat.museum-digital.de/contact)
+kann in der deutschlandweiten Instanz von museum-digital eingesehen werden.
+
+Als mittlerweile internationales Projekt haben sich in anderen Ländern andere
+Organisationsstrukturen herausgebildet. In Ungarn etwa gibt es ein zentrales Team
+von Betreuern.
+
+## Entscheidungen
 
 Weitere Entwicklungen bei museum-digital geschehen auf Anregung aus den Museen
 oder ihren Verbänden. Grundsätzliche Änderungen, d.h. Änderungen, die
@@ -26,10 +30,4 @@ zum Tragen kommen und andere Versionen nicht tangieren, werden dann
 umgesetzt, wenn die entsprechenden Versions-Betreuer es für nötig
 halten.
 
-Alle konzeptuellen Änderungen (z.B. Aufnahme privater Sammlungen in das
-Verzeichnis) werden in der AG Digitalisierung des Museumsverbandes
-Sachsen-Anhalt diskutiert und entschieden.
-
-[**\> Hier geht es zur aktuelle
-Kontakteliste.**](https://nat.museum-digital.de/index.php?t=kontakt)
-
+![Die AG Digitalisierung trifft sich in Quedlinburg](../assets/chapter_1-2/agdib_quedlinburg_800.jpg)

src/SUMMARY.md

@@ -43,13 +43,13 @@
 # musdb
 
 - [musdb](./musdb/README.md)
-  - [Benutzerkonto]() <!-- (./musdb/Benutzerkonto/README.md) -->
+  - [Benutzerkonto](./musdb/Benutzerkonto/README.md)
     - [Zugang erhalten](./musdb/Benutzerkonto/Zugang-erhalten.md)
     - [Nutzerrollen und -Rechte](./musdb/Benutzerkonto/Berechtigungen.md)
     - [Neue Benutzer hinzufügen](./musdb/Benutzerkonto/Neues-Kontro-hinzufuegen.md)
     - [Einstellungen (Privat)](./musdb/Benutzerkonto/Einstellungen.md)
-    - [Kontoeinstellungen und Sicherheit]() <!--- (./musdb/Benutzerkonto/Neues-Kontro-hinzufuegen.md) --->
-    - [Benutzerprofil]() <!--- (./musdb/Benutzerkonto/Neues-Kontro-hinzufuegen.md) --->
+    - [Kontoeinstellungen und Sicherheit](./musdb/Benutzerkonto/Kontoeinstellungen-Sicherheit.md)
+    - [Benutzerprofil](./musdb/Benutzerkonto/Profil.md)
   - [Benutzeroberfläche]() <!-- (./musdb/UI/README.md)-->
     - [Navigationsleiste](./musdb/UI/Navigationsleiste.md)
     - [Übersichts-Suche]()

src/musdb/Benutzerkonto/Kontoeinstellungen-Sicherheit.md

@@ -0,0 +1 @@
+# Kontoeinstellungen und Sicherheit

src/musdb/Benutzerkonto/Neues-Kontro-hinzufuegen.md

@@ -12,33 +12,32 @@ Nach dem Anmelden im Eingabe- und Bearbeitungstool von museum-digital
 erscheint am oberen Rand des Bildschirms eine Symbolleiste. In dieser
 Symbolleiste findet sich ein Museumssymbol. Wird dieses mit der Maus
 überfahren öffnet sich ein kleines Menü mit Unterpunkten. Gleich der
-erste dieser Menüpunkte heißt \"Benutzer\". Der Bezeichnung des
-Menüpunktes folgt ein Stift (das Symbol für \"Benutzer bearbeiten\") und
-ein \"+\" als Symbol für \"Benutzer hinzufügen\". Ein Klick auf dieses
+erste dieser Menüpunkte heißt "Benutzer". Der Bezeichnung des
+Menüpunktes folgt ein Stift (das Symbol für "Benutzer bearbeiten") und
+ein "+" als Symbol für "Benutzer hinzufügen". Ein Klick auf dieses
 Symbol öffnet das Fenster zum Neueintrag eines Nutzers:``
 
  ![](../../assets/musdb/neuer_nutzer.JPG)
 
 Dieses Eingabefenster muss vollständig ausgefüllt werden. Unter
-\"Anmeldename\" ist jener Name einzutragen, mit dem der zukünftige
+"*Anmeldename*" ist jener Name einzutragen, mit dem der zukünftige
 Nutzer sich später anmelden muss (er kann ihn nach erfolgter Anmeldung
-ändern). In das Feld \"Wirklicher Name\" tragen Sie bitte keinen Alias
-sondern den tatsächlichen Namen des zukünftigen Benutzers ein. Um
-fortgeschrittene Funktionen wie das Benutzerprofil zu benutzen sollte
-der hier eingegbene Name darüber hinaus einzigartig sein. In das Feld
-\"Email\" ist unbedingt eine funktionierende Email-Adresse einzutragen,
-ohne diese kann das Verfahren nicht abgeschlossen werden. Schließlich
-ist eine passende Rolle für den neuen Nutzer zu wählen.
+ändern). In das Feld "*Wirklicher Name*" tragen Sie bitte keinen Alias
+sondern den tatsächlichen Namen des zukünftigen Benutzers ein. Der hier
+eingegbene Name sollte darüber hinaus einzigartig sein. In das Feld
+"*e-Mail*" ist unbedingt eine funktionierende e-Mail-Adresse einzutragen,
+denn ohne diese kann der Benutzer sein Konto nicht aktivieren. Schließlich
+ist eine passende [Benutzerrolle](Berechtigungen.html) für den neuen Nutzer zu wählen.
 
-Sobald alle Felder ausgefüllt und \"Abschicken\" geklickt wurde schickt
-das System dem zukünftigen Nutzer eine email. Diese email enthält einen
+Sobald alle Felder ausgefüllt und "Abschicken" geklickt wurde, schickt
+das System dem zukünftigen Nutzer eine e-Mail. Diese e-Mail enthält einen
 Link, den der neue Benutzer anklicken (oder in die URL-Zeile kopieren)
 kann. Folgt der Angeschriebene diesem Link gelangt er auf eine Seite,
 auf welcher - gemäß DSGVO - erklärt wird, welche Angaben bei
-museum-digtial von ihm gespeichert werden. Unten auf dieser Seite kann
+museum-digital von ihm gespeichert werden. Unten auf dieser Seite kann
 er sich selbst ein Passwort vergeben. Mit dem Setzen eines Passwortes
 und Klick auf Abschicken erklärt sich der neue Nutzer mit der
-notwendigen Speicherung seiner email-Adresse einverstanden. Danach ist
+notwendigen Speicherung seiner e-Mail-Adresse einverstanden. Danach ist
 das Konto aktiviert und der neue Nutzer kann sich mit dem ihm vom
 Einrichtenden vergebenen Anmeldenamen sowie dem von ihm selbst gesetzten
 Passwort in der entsprechenden Instanz von museum-digital anmelden.
@@ -49,4 +48,3 @@ von vorne begonnen werden. Wichtig auch: Ein gültiges Passwort muss
 **mindestens 8 Zeichen** umfassen und dabei wenigstens ein Sonderzeichen
 enthalten.
 
- 

src/musdb/Benutzerkonto/Profil.md

@@ -0,0 +1 @@
+# Benutzerprofil

src/musdb/Benutzerkonto/README.md

@@ -1 +1,25 @@
 # Benutzerkonto
+
+Um musdb benutzen zu können, braucht man zuerst einmal ein Benutzerkonto.
+Dieses Kapitel beginnt mit einer Erläuterung, [wie man ein Benutzerkonto bekommt](Zugang-erhalten.md),
+
+Es folgt eine Beschreibung des [zweistufigen Rechtekonzeptes von musdb](Berechtigungen.md).
+Jedem Benutzeraccount ist eine Benutzerrolle zugewiesen, die einerseits bestimmt,
+ob der Benutzer andere Benutzeraccounts anlegen und verwalten kann. Andererseits
+liefert die Benutzerrolle Voreinstellungen für die Berechtigung, um etwa Objekt-Basisdaten
+oder Objekt-Abbildungen zu bearbeiten. Diese sehr viel genaueren Berechtigungen können im
+Nachhinein und entgegen der Vorgabe durch die Benutzerrolle eingestellt werden.
+
+Als nächstes wird die Perspektive des ersten Unterkapitels umgedreht: Es wird beschrieben,
+[wie man selbst Accounts für Andere anlegen kann](Neues-Kontro-hinzufuegen.md).
+
+In den Sektionen ["Einstellungen (Privat)"](Einstellungen.md) und
+["Kontoeinstellungen und Sicherheit"](Kontoeinstellungen-Sicherheit.md) werden
+verschiedene Möglichkeiten, sich die Oberfläche von musdb anzupassen und das eigene Konto
+abzusichern erklärt.
+
+Eine dieser Einstellungen ist die Möglichkeit, grundlegende Informationen - eine
+kurze Biographie und vor allem Kontaktinformationen - zu sich selbst für andere
+Benutzer freizugeben. Mithilfe des so freigegebenen [Benutzerprofils](Profil.md) können
+etwa neue Mitarbeiter in größeren Häusern leichter nachvollziehen, wer das Objekt Jahre
+zuvor bearbeitet hat.

src/musdb/Benutzerkonto/Zugang-erhalten.md

@@ -3,7 +3,7 @@ Zugang erhalten
 
 museum-digital ist eine Community. Um Zugang zu erhalten, muss man sich
 an einen schon vorhandenen Benutzer wenden. Im Zweifelsfall heißt das,
-dass entweder der Museumsdirektor eines Museums Zugang gibt, oder dass
+dass entweder der Museumsdirektor eines Museums Zugang gibt - oder, dass
 sich Museen, die noch nicht bei museum-digital sind, bei den
 Administratoren ihrer jeweiligen Instanz melden, um Zugang zu erhalten.
 
@@ -13,6 +13,41 @@ Link. Folgt man diesem Link, kann man die Anmeldung beenden, indem man
 die Datenschutzvereinbarung zur Benutzung von musdb akzeptiert und sich
 ein Passwort gibt.
 
-Bei neuen Benutzern sind ihre Rechte standardmäßig entsprechend [ihrer
-Benutzerrolle](../Benutzerkonto/Berechtigungen.md)
-vergeben. Sie können im Nachhinein angepasst werden.
+In der Mail finden sich ebenfalls der Username und ein Link zum Anmeldebildschirm
+von musdb, wo der Username und das gerade gesetzte Passwort verwendet werden können.
+
+![Login-Bildschirm von musdb: Links können die Logindaten eingetragen werden](../../assets/musdb/login/musdb-Login.jpg)
+
+Loggt man sich zum ersten Mal ein, erscheint zuerst einmal eine kurze Einführung in
+die grundlegendsten Konzepte der Benutzung von musdb. Diese Einleitung erscheint auch
+nach einer Abwesenheit von mehr als einem halben Jahr.
+
+## Ablaufen der Einladung
+
+Der Link zur Aktivierung des Accounts ist nach versenden drei Tage nutzbar -
+sind die drei Tage verstrichen, ohne dass der Account vollständig aktiviert
+wurde, wird er gesperrt und mittelfristig gelöscht. Aus Sicht des Museumsdirektors
+oder Administrators ist es daher ratsam, Accounts gemeinsam mit neuen Nutzern
+anzulegen oder neue Accounts lieber Montags als Freitags - vor dem Wochenende
+anzulegen.
+
+## Benutzerrechte
+
+Beim Anlegen eines neuen Benutzeraccounts muss eine
+[Benutzerrolle](../Benutzerkonto/Berechtigungen.md) für den neuen Benutzer
+ausgewählt werden. Diese Rolle entscheidet über die grundlegenden Berechtigungen
+des Benutzers. Feinere Einstellungen des Berechtigungen (etwa, wenn ein Benutzer
+nur eine Sammlung bearbeiten können soll) können eingestellt werden, sobald der
+neue Account aktiviert ist.
+
+## "Ich habe schon ein Konto. Aber wo ist musdb?"
+
+Die "Ausgabe" von museum-digital ist für die Veröffentlichung optimiert und hat
+deshalb keinen (!) Link zum dazugehörigen Login. Deshalb passiert es immer wieder,
+dass Benutzer - besonders solche, die nur selten direkt mit der Datenbank arbeiten -
+den Loginscreen nach Monaten schlicht nicht wiederfinden.
+
+Die Einladungsmail beinhaltet wie schon oben besprochen einen Link in zur jeweiligen
+Instanz von musdb. Aber es geht auch einfacher: Navigiert man zur jeweiligen regionalen
+Instanz der Ausgabe und fügt hinten an die URL "/musdb" an, wird man zur Eingabeoberfläche
+geleitet.

src/musdb/README.md

@@ -2,10 +2,12 @@ Erfassen und Bearbeiten: musdb
 ==============================
 
 Für die Eingabe und die Bearbeitung von Museums-, Sammlungs- oder
-Objektinformationen gibt es ein eigenes Werkzeug bei museum-digital, das
-\"Eingabe- und Bearbeitungstool\", **musdb**. Sobald ein Administrator
-ein Museum bei museum-digital eingerichtet hat, richtet er auch einen
-Zugang für mindestens einen Mitarbeiter in der Rolle \"Museumsdirektor\"
+Objektinformationen gibt es ein eigenes Werkzeug bei museum-digital:
+*musdb*. Wie alle anderen Tools von museum-digital ist musdb browser-basiert
+und wird von Museen einer Region gemeinsam benutzt.
+
+Sobald ein Administrator ein Museum bei museum-digital eingerichtet hat,
+richtet er auch einen Zugang für mindestens einen Mitarbeiter in der Rolle "Museumsdirektor"
 ein. Mit diesem Zugang können dann weitere Zugänge für das Museum - ganz
 ohne Zutun des Administrators - angelegt werden. Die Handhabung des
 Eingabe- und Bearbeitungstools wird in den entsprechenden Unterpunkten
@@ -13,17 +15,17 @@ erläutert. Das Werkzeug verfügt über eine eigene, stets erreichbare
 Navigationsleiste, mit der sich grundsätzliche Einstellungen vornehmen
 lassen.
 
-Diese Sektion beschreibt in ihren Unterpunkten die Gründzüge des
+Diese Sektion beschreibt die Gründzüge des Arbeitens mit musdb.
 Erfassens oder Bearbeitens von Objektinformationen bei museum-digital.
 Prinzipiell gibt es für das Erfassen zwei Möglichkeiten: Das Importieren
 und das händische Eingeben - beides wird näher erläutert. Einige
 Einstellungen des Programmes erlauben es dem Eingebenden oder Bearbeiter
-die Arbeit zu erleichtern indem \"Vorgabewerte\" gesetzt werden (etwa:
-\"Wenn-nicht-anders-angegeben-dann-verwende-folgendes\"). Auch diese
+die Arbeit zu erleichtern indem "Vorgabewerte" gesetzt werden (etwa:
+"Wenn-nicht-anders-angegeben-dann-verwende-folgendes"). Auch diese
 Einstellungen, die teils für alle Eingebenden oder Bearbeiter eines
 Museums gelten, teils nur einzelne Bearbeiter betreffen, werden erklärt.
 
+## Weitere Quellen
+
 Eine Playlist mit Screencasts zu musdb ist [hier auf Youtube zu
 finden](https://www.youtube.com/playlist?list=PLFbmcALPcmvLtbv38OpjEkHFteP-qhmDY).
-
-