Pistikprogrammid, skriptid ja utiliidid
Kui olemasolev programm peaks tegema rohkem — vahetama andmeid teise teenusega, töötlema faile automaatselt või lisama töötavasse liidessse nupu või käsu — on tavaliselt tegu pistikprogrammi, skripti või väikese utiliidiga. Selliseid ülesandeid lahendatakse punkthaaval: süsteemi ei kirjutata ümber, vaid laiendatakse eraldi mooduliga. Enne pöördumist tasub sõnastada, mis täpselt juhtuma peab: millised andmed sisenevad, mida programm nendega teeb ja mis sündmusel see käivitub — graafiku järgi, nupuvajutusel, uue faili ilmumisel või välise teenuse vastusel.
Valmistage ette lähteandmed. Kirjeldage, kus põhitoode töötab ja mis versioon see on, mis keeles või platvormil see on kirjutatud ja kas laiendustele on juurdepääs. Lisage näide sisendandmetest: faili katkend, näidispäring või vormi ekraanipilt. Sõnastage oodatav käitumine: mis peab juhtuma tavapärases stsenaariumis ja kuidas käituda vea korral — kas skript peatub ja kirjutab logisse teate või proovib uuesti. Eraldi loetlege käivitustingimused: kontod, õigused, graafik.
Päringus märkige, kas paigaldus on vajalik testkeskkonda või töökeskkonda, kes haldab moodulit pärast üleandmist ja kas dokumentatsioon on vajalik. Kui teil on prototüüp või loogika visand, lisage see — see vähendab ebaselgust. Leppige eelnevalt kokku lähtekoodi üleandmine, paigalduskord ja kontrollistsenaariumid: millised juhtumid loetakse õnnestunuks ja millised piirjuhtudeks.
Vastuvõtt toetub kontrollistsenaariumitele. Käivitage need testandmetel: tavaline päring, tühi fail, vale vorming, korduskäivitus, kättesaamatu välisteenus. Veenduge, et veateated on arusaadavad ja logi võimaldab aru saada, mis juhtus. Kontrollige, et paigaldus on kirjelduse järgi puhtas keskkonnas korratav. Kui käitumine erineb oodatust, fikseerige konkreetne näide — nii kulgeb täiendus kiiremini.
Sisuhaldussüsteemi või veebilehe juures võib pisem moodul lahendada korduva töö: näiteks päringuvormi andmete edastamine teenusesse või failide automaatne töötlemine. Sel juhul täpsustage lähteülesandes, milliseid välju ja sündmusi see puudutab.
Avalda ülesanne või paku oma teenust.