Grrr ([info]grrr) rakstīja [info]koderi kopienā,
@ 2004-06-11 15:47:00
Previous Entry  Add to memories!  Tell a Friend!  Next Entry
Oral Documentation - Not Worth the Paper It's Written On
http://www.hacknot.info/hacknot/action/showEntry?eid=57
When it comes to the maintenance and extension of legacy code, and clearing the organizational hurdles associated with the handover of code from one party to another, a reliance on "face to face" communication is very convenient for the first generation of developers, and a chain around the leg of every other developer and organization involved thereafter.

(Ierakstīt jaunu komentāru)


[info]smejmoon
2004-06-11 16:09 (saite)
virsraksts tendenciozs.

Citāts, kurš tiek apspēlēts ir: "The most efficient and effective method of conveying information to and within a development team is face-to-face conversation".

Vai Tu, Grrr, tam nepiekrīti?

(Atbildēt uz šo) (Diskusija)


[info]grrr
2004-06-11 17:03 (saite)
Nepiekrītu, jo pārāk vispārīgi.
Ir informācija, kuru ir daudz vērtīgāk nodot rakstiskā, strukturizētā veidā.

Kā piemēram lietotāju autentikācijas sistēma, ko vakar pabeidzu un piebāzu pie projekta.

Diez vai man pārējie developeri teiktu paldies, ja es viņiem noorganizētu telekonferenci ar ASV (kur daļa no viņiem sēž) un stāstītu visas Security fiškas mutiski. :P

(Atbildēt uz šo) (Iepriekšējais) (Diskusija)


[info]smejmoon
2004-06-11 18:13 (saite)
Un ja viņiem rodas kādi jautājumi?

Nekur jau nav teikts, ka sarunas ir vienīgais veids, kā sazināties. Es vienkārši labāku nezinu. Un precīzāku, kā kodu ar smalkiem testiem.

Haknots ir nelaimīgs fleimeris. Žēl, ka uzrāvos.

(Atbildēt uz šo) (Iepriekšējais) (Diskusija)


[info]grrr
2004-06-12 14:36 (saite)
> Haknots ir nelaimīgs fleimeris. Žēl, ka uzrāvos.
Nu jau tu sāc runāt tikpat tendenciozi kā viņš. :)

(Atbildēt uz šo) (Iepriekšējais) (Diskusija)


[info]smejmoon
2004-06-12 15:01 (saite)
- kādu attīstību Tu redzi viņa tekstiņos?
- vai viņš ir ko iemācījies no agile, citiem procesiem?

fleimeris tapēc, ka cilvēki uzraujās uz nepamatota bazara
nelaimīgs - es izlasīju par viņa darbadienu. jautri, bet cik ilgi tā var strādāt?

(Atbildēt uz šo) (Iepriekšējais)


[info]smejmoon
2004-06-12 15:08 (saite)
kļūdu labojums. nevis haknots, bet misters Edis.

Viņš jau vismaz gadu interesējās par XP trūkumiem. būtu jau laiks jēgt, ka tā nav nekāda sudraba lode.

(Atbildēt uz šo) (Iepriekšējais) (Diskusija)


[info]grrr
2004-06-13 11:25 (saite)
Katram tekstam pamatā ir cilvēka pieredze.

Saprotams, ka viņa _agresivitāte_ pret XP liecina par viņa konkrēto pieredzi nevis par XP kā izstrādes metodoloģiju.

"būtu jau laiks jēgt, ka tā nav nekāda sudraba lode."
Man domāt, tas ir viens no šī websaita mērķiem. Norādīt, ka pati par sevi XP tieši arī nav nekāda sudraba lode. Ir gana daudz izstrādātāju, kuri "XP" izmanto kā \m/. Tiesa gan, es šo Mr.Eda rakstu neuztvēru kā pret XP vērstu.

Saki labāk, vai tu varētu piekrist sekojošam:
- kvalitatīvam programmētājam, kurš rēķinās ar to, ka viņa izstrādāto lietos arī citi cilvēki, iespējams citā pasaules malā, ir jānodrošina, ka viņa veidoto publisko funkciju(klašu, interfeisu, struktūru, utt.) izmantošana neprasīs to izejas koda lasīšanu. Kā viņš to dara - tā ir programmētāja paša darīšana.

Ja runa ir tieši par _dokumentāciju_, nevis komunikāciju vispār, tad man grūti iedomāties, kā jēdziens "oral documentation" še var līdzēt.

(Atbildēt uz šo) (Iepriekšējais) (Diskusija)


[info]smejmoon
2004-06-13 13:14 (saite)
Manuprāt, ir jādokumentē interfeisi, kā Tu teici, protokoli un mērķis - ko ir gribēts panākt. Jādokumentē arī visādi haki un pieņēmumi. (Pieņēmumus gan labāk ar assertiem)

Mums tagad darbā ir 6 izstrādātāji vienā valstī un sāku just dokumentācijas nepieciešamību. Vēl vairāk prasās sīkāki testi.

(bet nekur neesmu manījis, ka Mr. Edim būtu pieredze ar XP :p)

(Atbildēt uz šo) (Iepriekšējais) (Diskusija)


[info]grrr
2004-06-13 22:41 (saite)
Nu, ja palasas dziļāk vēsturē, tad cik saprotu, pieredze viņam kāreiz ir ar cilvekiem, kuri _apgalvo_, ka izmanto XP. Kas attiecas uz viņu pašu, tad, ja atceros bija kaut kas par pair-programming. :-) Un visa žults no tā, ka ar XP praksi acīmredzot varen viegli ir bijis aizsegties dažiem vienkārši slinkiem un neizdarīgiem programmētājiem (Jāpiezīmē, ka spriežu, protams, no viņa rakstītā, jo pašam tajā iedziļināties nav bijis vajadzības).

(Atbildēt uz šo) (Iepriekšējais) (Diskusija)


[info]smejmoon
2004-06-13 22:47 (saite)
:-)

(Atbildēt uz šo) (Iepriekšējais)

Neesi iežurnalējies. Iežurnalēties?