software engeneering --> dokumentation??!

[figuerro]

hey leute..
bei uns im info lk.. haben wir im moodle nen kleines wiki.
und jeder soll einen teil der wichtigsten wörter der Grundkonzepte des Software-Engineerings schreiben.
ich habe "dokumentation", aber wenn ich ehrlich bin ich habe keine ahnung was die dokumentation in dem fall ist...
sie ist das letzte, also wenn man entwürfere gemacht hat, programmiert hat...
z.B.
" Problemanalyse?

Modellierung

Entwurf

Implementation

Test

Revision

Dokumentation"

was könnte das dann wenn es schon der letzte schritt ist sein?

ich muss da nur ne ganz kurze zusammenfassung schreiben. zwei drei sätze..
ist das nur die dokumentation von allem damit andere programmierer nachvollziehen können was man getan hat? oder sindn das diese kommentare in dem java programm?

mfg figuerro

 

[0x7F800000]

ist das nur die dokumentation von allem damit andere programmierer nachvollziehen können was man getan hat?

...damit überhaupt jemand nachvollziehen kann, was da gemacht wurde. Nach paar Jahren kann man eigenen undokumentierten Code meistens auch nur bedingt verstehen, neu schreiben ist evtl. einfacher, als alten Kram nachzuvollziehen, das ist dann quasi zum wegschmeißen.

oder sindn das diese kommentare in dem java programm?

nicht irgendwelche, sondern die javadoc Kommentare. Die normalen Kommentare im weitesten Sinne auch, diese tragen ja auch zum verständnis bei...

Was ist denn eigentlich so schwer bei Wikipedia nachzuschlagen was genau gemeint ist? Was eine Wiki ist weißt du ja jetzt^^ :autsch:
Softwaredokumentation ? Wikipedia

 

[bygones]

Implementation

Test

das ist schonmal die falsche Richtung...

Test

Implementation

wenn schon (um mal TestDrivenDevelopment hervorzuheben)

 

[0x7F800000]

while(!alles ok){
   test
   implementation
}

...?

 

[Painii]

testImplementieren
while(!allesOK){
 programmImplementieren
 testen
}

So wohl eher

 

[bygones]

while(AnforderungNochNichtErreicht) {
  writeFailingTest();
  implementMinimalToGetGreenBar();
}

 

[maki]

Bei TDD wird zuerst der Test geschrieben, danach der zu testende Code

Die 3 Regeln des TDD:

* Write no production code without failing tests
* Write only enough test code so that it fails (not compiling is failing)
* Write only enough production code to get your tests to pass.

Hört sich im ersten Moment zwar schräg an, aber wenn man das so macht, befindet man sich in einem Zyklus von ca. 30 -60 Sek. (Red/Green/Refactor), d.h. eigentlich wird der Testcode und der Prod. Code (fast) gleichzeitig geschrieben, aber der test Code ein paar Sekunden vor dem Prod. Code.
Das schwierige an TDD ist imho die Lernkurve, bin da selber noch mittendrin.