Easier to read with cream paper, a tint, more contrast or larger text? Choose your colours and text, once, for every page.

Vorschau

Code lesbar machen und dokumentieren

Das ist die erste Seite der Lektion. Lies sie und probier die Aufgaben aus. Der Rest steht im ganzen Kurs.

30 Minuten

Dein Programm von vor drei Wochen

Du öffnest ein Programm, das du selbst geschrieben hast. Es heißt f, die Variablen heißen a, b und x.

Du weißt nicht mehr, was es tut. Dein Team weiß es erst recht nicht.

Lesbarer Code spart allen Zeit, auch dir.

Am Ende dieser Lektion

Notiz

Ich kann Namen und Kommentare so wählen, dass andere mein Programm verstehen.

Schlüsselwörter

BegriffWas er bedeutetBeispiel
NameDas Wort, mit dem du eine Variable oder Funktion aufrufst.gesamtpreis
KommentarText im Code, den der Computer überspringt.# Rabatt für Vereine
DokumentationTexte, die erklären, wie ein Programm zu benutzen ist.
READMEEine Textdatei, die als Erstes erklärt, was das Projekt ist.
LesbarkeitWie leicht andere den Code verstehen.

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Einstieg: Programme testen

Probier es aus

Einstieg: Programme testen

4 Fragen
Probieren Sie es aus: Ihre Antworten werden hier bewertet und danach vergessen. Melden Sie sich an, wenn Ihre Punktzahl gespeichert werden soll und Sie später dort weitermachen möchten, wo Sie aufgehört haben.Anmelden, um die Punktzahl zu behalten

Deine Antworten werden hier bewertet und nicht gespeichert. Mit einem Konto bleiben deine Ergebnisse erhalten.

Gute Namen erklären sich selbst

Ein guter Name sagt, was in der Variable steckt oder was die Funktion tut.

Schlecht: x, a, f. Gut: gesamtpreis, anzahl, preis_mit_rabatt.

Wähle Wörter, die du laut vorlesen kannst. Dann brauchst du oft gar keinen Kommentar.

Beispiel: schwer zu lesen

Code: python
def f(a, b):
    x = a * b
    return x * 0.9

print(f(4, 2.5))

Beispiel: dasselbe, gut lesbar

Code: python
# Berechnet den Preis für mehrere Brötchen mit 10 % Rabatt.
def preis_mit_rabatt(anzahl, einzelpreis):
    gesamtpreis = anzahl * einzelpreis
    # Der Verein bekommt immer 10 % Rabatt, also zahlt er 90 %.
    return gesamtpreis * 0.9

print(preis_mit_rabatt(4, 2.5))

Kurz geprüft: Namen

Probier es aus

Kurz geprüft: Namen

3 Fragen
Probieren Sie es aus: Ihre Antworten werden hier bewertet und danach vergessen. Melden Sie sich an, wenn Ihre Punktzahl gespeichert werden soll und Sie später dort weitermachen möchten, wo Sie aufgehört haben.Anmelden, um die Punktzahl zu behalten

Deine Antworten werden hier bewertet und nicht gespeichert. Mit einem Konto bleiben deine Ergebnisse erhalten.

Die Lektion geht weiter

8 weitere Teile dieser Lektion stehen im ganzen Kurs, mit den Aufgaben und der Abschlussprüfung. Mit einem Konto bekommst du alles.