Pitäis alotella koodausprojekti johon osallistuu muutama tyyppi. En oo aiemmin tehny speksejä miltä koodi pitäis näyttää. Oon tehny tällaista pohjaa:
http://www.yourfilelink.com/get.php?fid=231207
(Ennen kuin käynnistät linkin, pistä ponnahdusikkunoiden esto päälle selaimesta).
Puuttuuko määrittelystä jotain / mitä pitäis lisäillä ?
http://www.yourfilelink.com/get.php?fid=231207
(Ennen kuin käynnistät linkin, pistä ponnahdusikkunoiden esto päälle selaimesta).
Puuttuuko määrittelystä jotain / mitä pitäis lisäillä ?
Vastaukset 3
Vanhimmat
Sain linkin auki vihdoin. On kattava selostus.
Pikasilmäyksellä ei ainakaan ollut mitään kommentoinnin / dokumentoinnin tasosta ja tyylistä. Ilmeisesti tulee olemaan c -projekti, kun C -osio on noin lyhyt.
Ei kai siinä suurempia, kun ryhmittelee hiukan toisin ja laittaa pari esimerkkiä selventämään.
En oo vielä päättänyt pitäisikö käyttää automaattista dokumentointia vai ei, joten en veilä speksannut tota osiota. Onks jollain kokemuksia ko. työkaluista ? Eikö ne tee kommenteista hieman epäselviä ?
Kieltämäti joitain dokumentointityökaluja varten tehdyt koodien kommentit ovat hieman epäselviä - varsinkin sellaiset jotka sisältävät erikoisempia html -muotoiluja. Tietysti sellaisille, jotka tietävät mitä merkinnät suunnilleen tarkoittavat, lukeminen ei tuota suuria ongelmia.
Riippuu paljolti minkälaisen lopputuloksen haluat lopputulokseksi työkalulta. Jos ajatellaan, että jokainen luokkamäärittely olisi omana tiedostonaan, ja riittäisi että työkalu osaisi poimia html-tiedostoihin (yksi per tiedosto):
- tiedoston otsikon ja muutaman seliterivin
- ei osaisi poimia jäsenfunktioiden/muuttujien kommentteja
niin työkalu ei tarvitsisi olla ihmeellinen tai lähdekoodin kommenttien vaikeaselkoisia.
Itse olen käytellyt muutamassa projektissa erästä kaupallista työkalua, jolla tulee hierarkiapuu ja kohtalainen seloste melko pienellä vaivalla, mutta kannattaa ensin katsella minkälaista lopputulosta kukin ohjelma tuottaa ja minkälaisella kirjoittelulla. Tietty pitää huomioida viitsiikö koodatessa mietiskellä ohjelman hienouksia kuten:
\f[
\left\{
u(a,t)-
\int_{\gamma(t)}^a
\frac{d\theta}{k(\theta,t)}
\int_{a}^\theta c(\xi)u_t(\xi,t)\,d\xi
\right\} dt
\f]
Ainakin työkaluvaihtoehtoja on tusina ilmaista ja vähintään toinen kaupallisia eli valinanvaraa on.