diff --git a/notebooks/seminar02.ipynb b/notebooks/seminar02.ipynb index f4830287ae5a4a5d5f742ac857fa5628517a0dc5..d68d2ec886bc75ac70a0fa861f82e3d282f213a2 100644 --- a/notebooks/seminar02.ipynb +++ b/notebooks/seminar02.ipynb @@ -546,6 +546,34 @@ "source": [ "Übrigens können wir uns mit aussagekräftigen Variablennamen auch Kommentare sparen. (Andererseits werden Ausdrücke durch sehr lange Namen auch schwerer lesbar ... wir müssen also einen guten Mittelweg finden.) \n", "\n", + "Finden Sie heraus, was das folgende Programm tut und fügen Sie aussagekräftige Kommentare hinzu:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import math\n", + "\n", + "x1 = 5\n", + "y1 = 4\n", + "x2 = 1\n", + "y2 = 1\n", + "\n", + "distance_h = x1 - x2\n", + "distance_v = y1 - y2\n", + "\n", + "distance = math.sqrt(distance_h**2 + distance_v**2)\n", + "\n", + "print(\"distance((x1, y1), (x2, y2)) = \", distance)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ "Exkurs: Wieviele Kommentare in einem Programm gut und notwendig sind, ist durchaus umstritten. Wenn Sie mögen, können Sie einen Ausschnitt des Diskurses dazu hier verfolgen:\n", "- \"Good code is its own best documentation.\" ([Steve McConnell](http://en.wikipedia.org/wiki/Steve_McConnell))\n", "- http://mikegrouchy.com/blog/2013/03/yes-your-code-does-need-comments.html\n",