Apollo-11/CONTRIBUTING.de.md
2020-10-04 16:47:13 +01:00

4.3 KiB

Contributing

🎌 Čeština, Deutsch, English, Español, Français, Kurdi, Nederlands, Português, Türkçe, العربية, 日本語, 正體中文, 简体中文, 한국어

Der Quellcode in diesem Repository wurde manuell digitalisiert, also sind jegliche schriftlichen Fehler und Ungereimtheiten aus Versehen hinzugefügt worden. Der Code soll so modifiziert werden, dass er mit den Vorlagen übereinstimmt.

Nützliche Erweiterungen

GitHub hat eine integrierte Unterstützung für AGC assembly. Das gilt leider nicht für deinen Editor. Für die folgenden Editoren gibt es aber AGC-Erweiterungen, die Syntaxhighlighting hinzufügen:

† unterstützt auch automatisches Formatieren

Formatierung

Anmerkung: GitHub und die oben erwähnten Erweiterungen werden automatisch sicherstellen, dass du die korrekte Formatierung einhältst.

  • benutze tab indentation
  • benutze tab width von 8
  • entferne Leerzeichen am Ende einer Zeile

Was soll ich überprüfen?

Alle Ungereimtheiten zwischen den Scans und dem Code in diesem Repository, einschließlich:

Kommentare

  • Kommentare in dem abgeschriebenen Code müssen denen in den Scans gleichen
    • Das kann bedeuten, dass man einen Rechtschreibfehler übernehmen oder einen ganzen Kommentar entfernen/hinzufügen muss

Zeilenumbruch

  • Zeilenumbrüche mit R0000 in Spalte 1 sollte genau mit den Scans übereinstimmen
  • Zeilenumbrüche ohne R0000 in Spalte 1 sollten nur ein bis zwei Leerzeilen nacheinander haben
    • Wenn es dort mehr als zwei Leerzeilen gibt, sollten die zusätzlichen Leerzeilen entfernt werden.
      • Zeilen mit R0000 in Spalte 1 zählen nicht dazu
    • In den Originalbildern wurden die durch eine nicht gedruckte Ziffer in Spalte 8 verursacht. Eine 2 dort hat ein doppeltes Leerzeichen (einzelne Leerzeile) und eine 3 hat ein dreifaches Leerzeichen (doppelte Leerzeile). Die Werte 4-8 wurden definiert, aber nie benutzt. Mehr dazu hier: #159

Beispiel:

R0819   SUBROUTINE TO SKIP...
R0820



 0821   LAMPTEST  CS  IMODES33

wird zu:

R0819   SUBROUTINE TO SKIP...
R0820


 0820   LAMPTEST  CS  IMODES33

Hinweis

Bevor du einen PR startest, überprüfe bitte, ob die Änderungen mit den Scans übereinstimmen!