Kirjautuminen

Haku

Tehtävät

Keskustelu: Nettisivujen teko: dokumentointi

Vasta_alkaja [29.03.2007 20:10:59]

#

Hei!!

Tietääkö kukaan, mistä löytäisi edes jonkinlaisen dokumentointi ohjelman, joka suorittaisi php koodin dokumentoinnin puolestani.

Tai tietääkö kukaan miten tämä tehdään ns. virallisesti

Kiitoksia paljon, teille kaikille jotka edes yritte ratkaista tätä.

tsuriga [29.03.2007 20:26:00]

#

http://www.phpdoc.org

Vasta_alkaja [29.03.2007 21:27:27]

#

Onkohan tuohon mahdollisesti mitään Suomenkielistä ohjeistusta millään sivulla, kun jäänyt sivistyksessä tuo Englanti vielä niin heikoille.

Jaska [29.03.2007 21:35:15]

#

Vasta_alkaja kirjoitti:

Onkohan tuohon mahdollisesti mitään Suomenkielistä ohjeistusta millään sivulla, kun jäänyt sivistyksessä tuo Englanti vielä niin heikoille.

Ja ilmeisesti myös suomi :). Veikkaisin, että dokumentointiohjelmat eivät mitenkään välttämättä tuota kieliopillisesti laadukkaita dokumentteja.

Vasta_alkaja [29.03.2007 21:39:45]

#

Pahus, niinpä näkyy olevan.

tsuriga [30.03.2007 00:17:33]

#

Ei noilla ole tarkoituskaan kirjoittaa mitään romaaneja, vaan niillä dokumentoidaan koodin jäsenet ja niiden toiminta - mikä muuttuja edustaa mitäkin ja minkälaista dataa mikin funktio palauttaa. Selkokielinen dokumentointi pitää tehdä aina käsin.

Vasta_alkaja [30.03.2007 07:24:50]

#

tsuriga kirjoitti:

Ei noilla ole tarkoituskaan kirjoittaa mitään romaaneja, vaan niillä dokumentoidaan koodin jäsenet ja niiden toiminta - mikä muuttuja edustaa mitäkin ja minkälaista dataa mikin funktio palauttaa. Selkokielinen dokumentointi pitää tehdä aina käsin.

Kyllä, näin minä oletinkin!

Pahus, niinpä näkyy olevan. <= Tällä tarkoitin vain kielioppiani. Sitä edeltävää vastausta on muokattu jälkeinpäin niin, että tämä sai aivan uuden merkityksen. Tämän ohjelman käyttöönotto vain tuottaa minulla tällä hetkellä ongelmia!

Vastaus

Aihe on jo aika vanha, joten et voi enää vastata siihen.

Tietoa sivustosta