Kasutaja arutelu:Oliverossip/käitumisel põhinev arendus

Tänan sisuka artikli eest! Lisan mõne kommentaari.

• Ilmselt on artikli suurim murekoht viitamine. Viide peab olema vähemalt iga lõigu lõpus ja ka ühegi üksiku lause puhul ei tohi tekkida küsimust, kust see pärineb. Mõistan, et oled aluseks võtnud ingliskeelse artikli ja seal on mõni viide puudu, aga ehk leiad praegu viiteta olevatele tekstiosadele muud allikad. Samas on viiteta ka mitu sellist kohta, kus ingliskeelses artiklis on viide olemas.
• Paljud laused on praegu konarlikud. Püüa tekst uuesti üle lugeda ja see paremini loetavaks teha, võid ka kelleltki abi paluda. Võib-olla aitab, kui kirjutatu endale kõva häälega ette lugeda: siis tulevad komistuskohad paremini esile. Toon edasistes punktides mõne näite.
• Sissejuhatuse teine lause on praegu väga segane: „Käitumisel põhinev arendus kombineerib üldiseid tehnikaid ja põhimõtted testimisel põhinevast arendusest koos domeenil põhinevast disainist ja objekorienteeritud analüüsist ja disainist“. Palun vaata see üle ja ürita selgemalt kirja panna.
• „Palju inimesi on arendanud BDD raamistikku üle aastate, lõpuks kujunes sellest suhtlemis ja koostöö raamistik tarkvara projektis arendajatele, testijatele ja tehnilise taustata inimestele(nt: kliendid, äripartnerid)“
  • „üle aastate“ -> „aastate jooksul“
  • „suhtlemis- ja koostööraamistik“
  • millega käib selles lauses kokku sõna „projekt“?
• Lausetes nagu „Käitumisel põhinev testimine kasutab pool-formaalset formaati käitumise väljendamiseks, mis on võetud kasutusloost (ingl.k user story)“ peab sõna, millega kõrvallause algab (siin „mis“) järgnema vahetult sõnale, mille kohta ta käib, nt „koer, keda nägin, oli musta värvi“). Lähtu teksti parandamisel sellest põhimõttest.
• Loetelu kujul „BDD keskendub: Kust alustada testimist; Mida testida ja mida mitte /../“ pole keeleliselt korrektne. Püüa saatelause („BDD keskendub“) loetelu liikmetega ühildada (nt „BDD kesksed küsimused on“ või „BDD keskendub sellele,“. Seejuures palun sul ka kirjavahemärgid ja algustähed loetelu reeglite järgi vormistada. Vt loetelu vormistamise näiteid ja reegleid siit ja pea neid silmas kõigi loetelude vormistamisel.
• „Title: The story should have a clear, explicit title“ tõlkeks ei sobi eesti keeles „Pealkiri: Omadus peaks olema selge ja pealkiri sõnaselgelt“. Palun püüa see täpsemini tõlkida.
• „Lühike, Sissejuhatav osa“ – „sissejuhatav“ väikese tähega: tegu on lause sees oleva tavalise sõnaga.
• Väldi sõna „teostama“, mis on enamasti tühisõna. Vaata lähemalt siit.
• Ka sulgude ees peab olema tühik.
• „nt“ järel ei pea koolonit olema
• Ingliskeelsed sõnad peavad olema kaldkirjas
• „inglise keeles behavior-driven development [koma] lühendatult BDD“
• „inglise keele“ lühend on „ingl“
• „ennem“ -> „enne“/“varem“
• Üks lõpuviide on praegu poolik.

Kui oled kommentaaride põhjal parandused teinud, anna palun siinsamas arutelulehel teada. Edu!

---

Õppeassistent --Kairijan (arutelu) 13. november 2018, kell 19:28 (EET)

Vabandused hilinemise pärast. Nüüd peaks parem olema.

--Oliverossip (arutelu) 6. detsember 2018, kell 18:24 (EET)

---

Tänud muutuste eest!

Palun pööra veelkord tähelepanu kirjavahemärkidele.

• Loetelu vormistamise põhimõte on tegelikult üsna lihtne: kui saatelause lõppeb kooloniga, käitub edasine loetelu nagu iga teinegi selline lause, kus on koolon (nt seesama siin). Nii läheks üks lause justkui edasi kuni loetelu lõpuni, see tähendab, et liikmed algavad väikese tähega ja nende lõpus on koma/semikoolon. Kui saatelause lõppeb punktiga, on aga iga element ise lause. Palun vt loetelu vormistamise näiteid ja reegleid siit (see on ju põhimõtteliselt spikker) ja pea neid silmas kõigi loetelude vormistamisel.
• See loetelu, mille esimene liige on "Kes?: Tegelane: klient, kasutaja, administraator jne" – et vältida kirjavahemärkide segadust, soovitan sul selle vormistada järgmiselt (kas see sobiks?).
  • Kes on loo põhitegelane (klient, kasutaja, administraator jne)?
  • Mida ta tahab teha?
  • Miks ta seda teha tahab?

• Palun märgi võrguallikatele ka kasutamise kuupäev.

Kui oled kõik need muudatused teinud, võid artikli põhiruumi laadida. Juhend selleks on siin. Siis on töö arvestatud!

Õppeassistent Kairijan (arutelu) 13. detsember 2018, kell 13:15 (EET)