Abnahme: Unterschied zwischen den Versionen
K |
K (→Rechtschreibung, Zeichensetzung, Grammatik) |
||
Zeile 11: | Zeile 11: | ||
Ein (vergleichsweiser) einfacher Einstieg in die Kontrolle ist die Überprüfung von ''Rechtschreibung, Zeichensetzung und Grammatik''. Die deutsche Sprache ist schwer genug und bietet fihle Fälerkwellen [sic!]. Manch einer kennt sich hier gut aus, manch anderer halt weniger. Es gilt im Zweifel die [http://rechtschreibrat.ids-mannheim.de/download/regeln2006.pdf neue deutsche Rechtschreibung] sowie, bei einigen optionalen Schreibungen, die Empfehlungen des [http://www.duden.de/ Dudens]. Bei Zufallsbegegnungen lässt sich die Rechtschreibung direkt hier im Wiki prüfen. Questen kann man auf dem [[Testserver]] durchspielen oder im [[AOQML-Editor]] lesen. Man kann sie aber auch mit TextEdit (macOS) oder vergleichbaren Programmen, wie zum Beispiel Notepad++, öffnen (Quest runterladen und entpacken, dann bei den einzelnen Daten Rechtklick, öffnen mit). Diese verfügen über eine Rechtschreibprüfung (bei Notepad++ müssen die deutschen Sprachpakete nachgeladen und aktiviert werden) und zeigen daher unter anderem Rechtschreibfehler an. | Ein (vergleichsweiser) einfacher Einstieg in die Kontrolle ist die Überprüfung von ''Rechtschreibung, Zeichensetzung und Grammatik''. Die deutsche Sprache ist schwer genug und bietet fihle Fälerkwellen [sic!]. Manch einer kennt sich hier gut aus, manch anderer halt weniger. Es gilt im Zweifel die [http://rechtschreibrat.ids-mannheim.de/download/regeln2006.pdf neue deutsche Rechtschreibung] sowie, bei einigen optionalen Schreibungen, die Empfehlungen des [http://www.duden.de/ Dudens]. Bei Zufallsbegegnungen lässt sich die Rechtschreibung direkt hier im Wiki prüfen. Questen kann man auf dem [[Testserver]] durchspielen oder im [[AOQML-Editor]] lesen. Man kann sie aber auch mit TextEdit (macOS) oder vergleichbaren Programmen, wie zum Beispiel Notepad++, öffnen (Quest runterladen und entpacken, dann bei den einzelnen Daten Rechtklick, öffnen mit). Diese verfügen über eine Rechtschreibprüfung (bei Notepad++ müssen die deutschen Sprachpakete nachgeladen und aktiviert werden) und zeigen daher unter anderem Rechtschreibfehler an. | ||
− | (Zehn [[Tipps]] eines Archivars aus Santo Tiberio | + | (Zehn [[Tipps für Rechtschreibung und Zeichensetzung]] eines Archivars aus Santo Tiberio.) |
==AOQML== | ==AOQML== |
Version vom 20. November 2023, 22:16 Uhr
Abnahme bezeichnet den Prozess der Prüfung und Korrektur künftiger Spielinhalte, bevor diese ins Spiel implementiert werden können.
Inhaltsverzeichnis
Allgemeines
Bei der Abnahme bzw. Kontrolle von Zufallsbegegnungen (ZB) und Quests sind einige Punkte zu beachten. Aber vorab: Niemand erwartet Perfektion! Weder vom Autor noch von den Testern. Es werden immer Fehler übrig bleiben, die mit implementiert werden. Solche fallen dann früher oder später im Realbetrieb auf, werden von aufmerksamen Spielern gemeldet und können schließlich behoben werden. Ziel des Abnahme-Prozesses ist freilich, die Anzahl der Fehler im Vorwege so weit wie möglich zu minimieren. Dazu gibt es verschiedene Möglichkeiten, wo man seine Expertise einbringen kann, die im folgenden erläutert werden. Und das wichtigste: Man muss kein AOQML beherrschen, um die Abnahme voranzutreiben. Der Testserver bietet eine Möglichkeit, (fast) wie im normalen Spiel auf Fehlersuche zu gehen. Rückmeldungen über mögliche Fehler sind für die Autoren sehr wichtig. Es muss nichts eigenständig korrigiert werden.
Umfang der Abnahme
Rechtschreibung, Zeichensetzung, Grammatik
Ein (vergleichsweiser) einfacher Einstieg in die Kontrolle ist die Überprüfung von Rechtschreibung, Zeichensetzung und Grammatik. Die deutsche Sprache ist schwer genug und bietet fihle Fälerkwellen [sic!]. Manch einer kennt sich hier gut aus, manch anderer halt weniger. Es gilt im Zweifel die neue deutsche Rechtschreibung sowie, bei einigen optionalen Schreibungen, die Empfehlungen des Dudens. Bei Zufallsbegegnungen lässt sich die Rechtschreibung direkt hier im Wiki prüfen. Questen kann man auf dem Testserver durchspielen oder im AOQML-Editor lesen. Man kann sie aber auch mit TextEdit (macOS) oder vergleichbaren Programmen, wie zum Beispiel Notepad++, öffnen (Quest runterladen und entpacken, dann bei den einzelnen Daten Rechtklick, öffnen mit). Diese verfügen über eine Rechtschreibprüfung (bei Notepad++ müssen die deutschen Sprachpakete nachgeladen und aktiviert werden) und zeigen daher unter anderem Rechtschreibfehler an.
(Zehn Tipps für Rechtschreibung und Zeichensetzung eines Archivars aus Santo Tiberio.)
AOQML
Ganz wichtig, wenn nicht gar entscheidend (weil die ZB/Quest sonst überhaupt nicht laufen würde), ist die korrekte Benutzung der AOQML-Syntax. Diese kann gut mit dem AOQML-Editor überprüft werden. Alternativ kann man einen anderen Editor benutzen, der vorzugsweise XML (und XSD) unterstützt (siehe z.B. XML-Werkzeuge).
Im Editor kann auch gleich die Code-Formatierung begutachtet werden. Sinnvolle Einrückungen und Leerzeilen sollten nicht fehlen. Ebenfalls willkommen sind Kommentare, sowohl erläuternder Art (z.B. was ein bestimmter Code-Teil genau bezwecken soll) als auch zur Kenntlichmachung des Anfangs und Endes von größeren Blöcken. Formatierung und Kommentierung wirken sich zwar nicht auf die Funktionalität aus, sie erleichtern aber die Kontrolle und spätere Wartung.
Zu guter Letzt kann man dem Autor ggf. Hinweise auf Code-Optimierungen geben. Selbstverständlich hat jeder seinen eigenen Stil, aber (fast) jeder Stil lässt sich noch verbessern. Ein beliebtes Beispiel sind sich wiederholende Textpassagen, welche sich etwa mittels Retain replay "vor die Klammer ziehen" ließen.
Logischer Aufbau, Hintergrund und Schwierigkeit
Kniffelig kann es bei der Kontrolle des logischen Aufbaus zugehen. Daher hier ein paar unlogische Beispiele:
- Der Held besiegt in einem Raum einen Gegner, kommt später wieder in diesem Raum, und der Gegner ist kommentarlos wieder da.
- Eben geht der Held noch am Tage durch einen Wald, betritt dann eine Lichtung, und plötzlich ist es laut Beschreibung mitten in der Nacht.
- Das alte Mütterchen Alrike, das dem Helden am Anfang einen Auftrag gegeben hatte, verwandelt sich zum Ende hin in den jungen Burschen Alrik.
Der Inhalt der ZB/Quest muss selbstverständlich zum kanonischen Hintergrund und zum offiziellen Regelwerk passen. Also bitte vor einer Kontrolle das gesamte Wiki durchlesen und die einschlägigen Themen im Forum nicht vergessen! Nein, natürlich nicht. Da Antamar an vielen Stellen noch im Entstehen begriffen ist, kann dieser Prüfpunkt manchmal recht kompliziert sein. Im Zweifel ruhig einmal mehr auf der Diskussionsseite der abzunehmenden ZB/Quest nachfragen oder Hinweise setzen, wenn einem etwas komisch vorkommt.
Der tatsächliche Schwierigkeitsgrad der ZB/Quest sollte den Vorstellungen des Autors entsprechen, wie er sie in der Infobox angegeben hat. Dies betrifft insbesondere die Modifikationen von Proben und die Gegnerwahl bei Kämpfen. Und wenn ein Held ausgeplündert werden soll, muss der Welpenschutz angemessen berücksichtigt sein.
Testserver
Questen kann man auf dem Testserver auch schon einmal richtig durchspielen. Dabei sollten mehrere Zweige ausprobiert und eventuell auch unterschiedliche Helden benutzt werden. Manchmal liefert der Autor der Quest auch einen "Cheat" mit, der z.B. benötige Gegenstände vergibt oder relevante Helden-Variablen setzt.
Prozess der Abnahme
Der Prozess der Abnahme besteht aus zwei Phasen.
Phase 1
Die erste Phase ist wiederum in zwei Schritte unterteilt. Als erstes wird der reine Inhalt (Sprache, Aufbau, Stimmigkeit) der ZB/Queste überprüft, als zweites das AOQML (Syntax, Semantik, Coding-Konventionen). Die Prüfung wird auf der entsprechenden Wiki-Seite mit jeweils einer Unterschrift an der vorgesehenen Stelle ("Folgende User haben den Text Korrektur gelesen...") dokumentiert.
Beide Schritte können von zwei Personen oder auch nur von einer durchgeführt werden. In letzterem Fall unterschreibt er/sie zweimal.
Phase 2
Die Phase 2 dient der Sicherheit, damit insgesamt mindestens zwei Personen an der Abnahme beteiligt sind. Es findet eine im Vergleich zur ersten Phase nur relativ schnellere Prüfung der o.g. Punkte statt. Sie wird von einem "erfahrenen" Helfer durchgeführt und mit der entsprechenden dritten Unterschrift dokumentiert.
Jeder, der Interesse hat und die notwendige Erfahrung mitbringt, kann die Unterschrift gerne setzen. Bedingung ist ein wenig Verständnis von AOQML (Grobe Lesefähigkeit) und die Ausdauer verschiedene Pfade erkennen zu können und durchzuexerzieren, zum Beispiel mit Hilfe von result. Und es sollte natürlich nicht eure erste Korrektur sein. Schätzt euch einfach ein bisschen selbst ein und dann los. Wichtig wäre die Prüfung von Warenvergaben, Warenentfernungen sowie EP-Vergabe und Welpenschutz sollte man auch schonmal gehört haben.