Add python docs

[xeruf]

No description provided.

[xeruf]

sieht grundlegend gut aus! @YoEnte

[YoEnte]

Okay, I guess that the content is alright, but there is still a lot missing which I plan adding this week, I would wait with a merge until then

[xeruf]

@YoEnte wie sieht's hier aus?

[YoEnte]

wip, waren noch einige andere (wichtigere) Dinge drum herum zu bearbeiten, das hier kommt als nächstes

[xeruf]

@YoEnte und? 🙃

[YoEnte]

@xeruf kannst nochmal reviewen, sollte jetzt soweit fertig sein, dass man es veröffentlichen kann.

OOP fehlt noch, hab erstmal was verlinkt, aber so langsam muss einfach was raus und da die Python API jetzt auch in den ersten Versionen draußen ist, wäre es erstmal gut so.

[xeruf]

sieht gut aus, nur ein paar kleinigkeiten

bitte nimm noch die zahlen aus den dateinamen raus - die Idee ist gut, aber dann muss man sobald man was ändern will auch alle links die vielleicht dahin zeigen aktualisieren - außer du kannst den seiten feste ids geben?

[xeruf]

Habs mir mal live angeschaut, ein paar weitere Kleinigkeiten:

• braucht's die OOP-Seite überhaupt bei Python? Ist das relevant ffür die Schüler oder reicht das Erwähnen der ressourcen auf einer der anderen seite? DU musst ja nicht 1:1 alles was bei Java steht so auch schreiben
• generell bitte Sätze mit "man" umformulieren, das ist oft sperrig - aber das kannst du auch noch nachreichen ist nicht so dringend

[xeruf]

es zeichnen sich schon deutliche verbesserungen mit sembr und dem schreibstil ab, hier noch ein paar anmerkungen :)

[YoEnte]

Habs mir mal live angeschaut, ein paar weitere Kleinigkeiten:

• braucht's die OOP-Seite überhaupt bei Python? Ist das relevant ffür die Schüler oder reicht das Erwähnen der ressourcen auf einer der anderen seite? DU musst ja nicht 1:1 alles was bei Java steht so auch schreiben
• generell bitte Sätze mit "man" umformulieren, das ist oft sperrig - aber das kannst du auch noch nachreichen ist nicht so dringend

Ich hab letztes Jahr einer Klasse die Basics in OOP beigebracht, weil die API halt OOP ist... deswegen wäre es grundsätzlich nicht schlecht meiner meinung nach

Und ja, das ist mir bewusst, versuche ich schon so gut es geht zu vermeiden. Kann man die Leser mit "Du" oder "Ihr" ansprechen? Weil aktuell versuche ich das auch zu vermeiden, sondern eine komplett neutrale Ansprache zu benutzen, die möglichst ohne "man" auskommt