{"id":399,"date":"2007-06-08T08:46:30","date_gmt":"2007-06-08T06:46:30","guid":{"rendered":"http:\/\/my.stargazer.at\/2007\/06\/08\/comment-it\/"},"modified":"2007-06-29T16:08:03","modified_gmt":"2007-06-29T14:08:03","slug":"comment-it","status":"publish","type":"post","link":"https:\/\/my.stargazer.at\/de\/2007\/06\/08\/comment-it\/","title":{"rendered":"Kommentare!!"},"content":{"rendered":"<p>Ich weiss nicht, wie lange ich es schon vor mir hergeschoben habe, meine alten PHP Projekte zu debuggen und auf aktuelle Standards zu bringen. Damit man seinen eigenen Code nicht stundenlang nach dem Sinn der Funktionen durchsucht ist Dokumentation das A und O &#8211; ich weiss wovon ich rede, da ich den gestrigen Tag damit verbracht habe, grosse Teile meiner Software aufgrund mangelnder Kommentare und Erkl\u00e4rungen neu geschrieben habe&#8230;<\/p>\n<p>Es ist nicht wichtig, einen Roman zu schreiben. Ich habe mir folgenden Standard angew\u00f6hnt (von JavaDoc geklaut):<\/p>\n<p><!--more--><\/p>\n<blockquote>\n<pre>\r\nMyExampleFnc($a as string, $b) {\r\n\/*************************************\r\nFunction:      My example function\r\nDescription:   This is just an exampe\r\n               that does nothing.\r\nParameters:    $a - string, example input string\r\n               $b - variant, another example\r\nOutput:        Function does this and that...\r\n**************************************\/\r\n...\r\n}<\/pre>\n<\/blockquote>\n<p>Was ich hier dokumentiere ist einfach erkl\u00e4rt: Function ist der lange Name einer Funktion, da man ab und an Namen vergibt, welche sp\u00e4ter nicht nachvollziehbar sind. Die Description ist eine kurze Beschreibung der Funktion, was sie tut. Parameters bezeichnet eine Liste, welche Argumente die Funktion annimmt und eine kleine Beschreibung ihrer. Der Output ist dann das, was die Funktion zur\u00fcckgibt. Damit ist es m\u00f6glich, in kurzer Zeit die gesamte Funktion neu zu schreiben, ohne sich erst stundenlang Gedanken dar\u00fcber zu machen, was es zu beachten gibt. Vergeudet keine Zeit &#8211; Kommentiert :)<\/p>","protected":false},"excerpt":{"rendered":"<p>Ich weiss nicht, wie lange ich es schon vor mir hergeschoben habe, meine alten PHP Projekte zu debuggen und auf aktuelle Standards zu bringen. Damit man seinen eigenen Code nicht stundenlang nach dem Sinn der Funktionen durchsucht ist Dokumentation das A und O &#8211; ich weiss wovon ich rede, da ich den gestrigen Tag damit verbracht habe, grosse [&hellip;]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[375],"class_list":["post-399","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-programming"],"_links":{"self":[{"href":"https:\/\/my.stargazer.at\/de\/wp-json\/wp\/v2\/posts\/399","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/my.stargazer.at\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/my.stargazer.at\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/my.stargazer.at\/de\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/my.stargazer.at\/de\/wp-json\/wp\/v2\/comments?post=399"}],"version-history":[{"count":0,"href":"https:\/\/my.stargazer.at\/de\/wp-json\/wp\/v2\/posts\/399\/revisions"}],"wp:attachment":[{"href":"https:\/\/my.stargazer.at\/de\/wp-json\/wp\/v2\/media?parent=399"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/my.stargazer.at\/de\/wp-json\/wp\/v2\/categories?post=399"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/my.stargazer.at\/de\/wp-json\/wp\/v2\/tags?post=399"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}