Funkcijų aprašymas programuotojui

Sveiki, prašau pagalbos ir paaiškinimų, kaip teisingai ir aiškiai išdėstyti programuotojui funkcijas kurias reikia padaryti.

Nuo ko pradėti ir koks formatas, bei kas turi būti parašyta.

Dėkui

Funkcionas pavadinimas: kaip turi veikti funkcioja.

Pavyzdžiui:

Registracija - 2 laukai, vardas ir slaptažodis. Vardas turi būti ne trumpesnis nei 5 simboliai ir ne ilgesnis nei 10. Slaptažodis turi būti koduojamas md5 ir ne trumpesnis nei 5 simboliai. Vartotojas iš vieno IP gali turėti tik vieną anketą.

Bent jau aš rašau kažką panašaus.

Koks formatas ar išdėstymas - tiek susitarimo ir bendro darbo patirties, tiek projketo sudėtingumo klausimas. Kartais pakanka žodžiu paaiškinti ir kelis punktus į .txt failą brūkštelti.

Bet iš patirties galiu rekomenduoti, kad nėra nieko geriau, kaip braižyti prototipą ir aprašyti visą funkcinę. Iš karto dėlioji rėmus ir aprašinėji veikimą. Plius čia nušauni vienu šūviu du zuikius - pagal prototipą dizaineris gali piešti, o programuotojas pradėti programuoti. O ir pačiam daugiau šansų kad pamatysi dalykus, apie kuriuos šiaip gal nepagalvoji.

Aš asmeniškai tam audoju programą axure - http://www.axure.com/ . Paprasta naudoti ir visiškai pakanka funkcijų.

Ir dar itin svarbu - prieš pradedant ilgai ilgai paie viską diskutuoti gyvai. :-)

Taip ir maniau, kad darbo aprašant viską bus laaaabai daug :(

Programuotojai nesuinteresuoti pasižiūrėti 'gyvą' pvz. ir pagal jį daryti (?) :)

Taip ir maniau, kad darbo aprašant viską bus laaaabai daug :(

 

Programuotojai nesuinteresuoti pasižiūrėti 'gyvą' pvz. ir pagal jį daryti (?) :)

Čia priklauso nuo projekto sudėtingumo, bet šiaip vistiek, tai, ką turi padaryti tu, užkrauni dar papildomai prohramuotojui. Tau tarkim atrodo, kad yra pvz ir pasižiūrėjus viskas aišku. Bet iš tiesų vis tiek reikia aiškintis visą veikimą, įvairias smulkmenas. Kaip pirma kažkas rašė - ar registruotis iš to ip gali vieną kartą ar daugiau ir t.t. O tai užima ne tiek mažai laiko.

O kita dalykas, dažnai pasako žmonės, man reikai maždaug kaip ten tam puslapy. Padarai, atrodo viskas ok, o tada prasideda - aš galvojau kad tas veiks taip, anas taip ir t.t. Ir tada pasirodo, kad nixuja puse dalykų turėjo būti ne kaip nurodytam pavyzdy. :-)

Na tas viskas suprantama, bet tam , kad nežinančiam, tokiam kaip man, išsiaiškinti gan sudėtingo projekto veikimo principa (seką), kas po ko, kas tada jeigu, jeigu taip tai kitaip ir tt. ir t.t. reikia savaitę sedėti ir aiškintis ir tai dar negarantuoja, kad viską aprašysiu teisingai, ko pasekoje kils nemažai nesusipratimų, kurių aš tikrai nežinosiu kaip išspręsti ir kaip paaiškinti programuotojui, kuris savo ruožtu sakys - 'tu pasakyk,aš padarysiu'

Gal kas galite padėti aprašyti?

Kaip programuotojas galiu (ne nemokamai) padėti aprašyti užduotis programuotojui. Aišku, tamstai teks man jas paaiškinti tiksliai, o aš suformuluosiu taip, kaip programuotojui tinka :rolleyes:

kaip man, išsiaiškinti gan sudėtingo projekto veikimo principa (seką), kas po ko, kas tada jeigu, jeigu taip tai kitaip ir tt. ir t.t. reikia savaitę sedėti ir aiškintis ir tai dar negarantuoja, kad viską aprašysiu teisingai, ko pasekoje kils nemažai nesusipratimų, kurių aš tikrai nežinosiu kaip išspręsti ir kaip paaiškinti programuotojui

O tai programuotojui nereikia išsiaiškinti. Rezultate bus taip, jog tu norėjai vienaip, programuotojas padarė kitaip ir teks daug ką keisti, kas rezultate kainuos tau daugiau pinigų, o programuotojui nervų. Nepatingėk ir normaliai surašyk ko tau reikia.

Nera nieko baisiau negu klientas, kuris pateikia kazkoki pavyzdi ir tikisi tokio pacio puslapio. Nei programuotojas naudojasi kazkokiomis vartotojui reikiamomis paslaugomis, nei jis zino, kas ten vyksta.

Geriausiai kai aprasomi visas puslapis, kas jame bus vaizduojama (ir is kur), kokie galimi veiksmai ir t.t.; nereikia gilintis i programine puse (pvz kaip sudaryti duomenu baze, kaip saugoti vartotoju duomenis ir pan.; nebent yra specifinis poreikis).

Tinka betkoks tekstinis dokumentas, jei imanoma - su iliustracijom. Pradedi nuo pacios pradzios, tada nagrineji kiekviena elementa atskirai.

Kaip programuotojas galiu (ne nemokamai) padėti aprašyti užduotis programuotojui. Aišku, tamstai teks man jas paaiškinti tiksliai, o aš suformuluosiu taip, kaip programuotojui tinka :rolleyes:

Ar galėtumėt ponas pagal pavizdį tai padaryti, tarkim iš veikiančios svetainės?

Nera nieko baisiau negu klientas, kuris pateikia kazkoki pavyzdi ir tikisi tokio pacio puslapio. Nei programuotojas naudojasi kazkokiomis vartotojui reikiamomis paslaugomis, nei jis zino, kas ten vyksta.

 

Geriausiai kai aprasomi visas puslapis, kas jame bus vaizduojama (ir is kur), kokie galimi veiksmai ir t.t.; nereikia gilintis i programine puse (pvz kaip sudaryti duomenu baze, kaip saugoti vartotoju duomenis ir pan.; nebent yra specifinis poreikis).

 

Tinka betkoks tekstinis dokumentas, jei imanoma - su iliustracijom. Pradedi nuo pacios pradzios, tada nagrineji kiekviena elementa atskirai.

Na man labai įdomu, kaip pavz. paaiškinti ir iliustruoti IPB forumo veikimą... čia tik kaip pavizdys.

Tai kiek menesių reikia viską aiškintis...

Trumpai, su minimaliu galimybiu aprasymu:

Pradinis puslapis - rodomas forumu sarasas. Kiekvienas forumas turi savo aprasyma, rodoma paskutines parasytos zinutes data, ir autorius. Apacioje rodomi visi prisijunge vartotojai per paskutines 15 min.

Forumo vidus - rodomos visos temos esancios forume, ... Galimybe priorituoti temas (svarbios, pinned etc)

ir t.t.

Darbo daug, bet galima aprasyti praktiskai viska :) Ne veltui tokie gigantai kaip IPB vystomi daug metu, o ne is karto viskas padaroma. Todel programine puse irgi turi buti atlikta apgalvotai, su galimybe lengvai viska keisti ir prideti naujas galimybes.

Na man labai įdomu, kaip pavz. paaiškinti ir iliustruoti IPB forumo veikimą... čia tik kaip pavizdys.

 

Tai kiek menesių reikia viską aiškintis...

* Paimi laika, kuri manai sugaisias issiaiskinimui ko TAU REIKIA (ne programuotojui), padaugini ji is 3, ir tai yra minimalus laiko tarpas kuri uztruksi, jeigu nesugebesi normaliai isaiskinti savo noru programuotojui. Kas tau pigiau - menuo ar minimum trys - jau spresti paciam.

* Antra, kam tau reikia funkcionalumo kurio pats nesupranti? Tai uzsakyk tik tai, ka pats suvoki. Jei reikes kazko daugiau, ir turesi suvokima kam tau to reikia ir kaip tai turi veikt - tai uzsakysi papildyma.

* Arba elementariai pakeisk poziuri - t.y. duok programuotojui pasireikst ir buk patenkintas tuo, ka gausi, be jokiu "as maniau", "as tikejausi" ir t.t.

* Paimi laika, kuri manai sugaisias issiaiskinimui ko TAU REIKIA (ne programuotojui), padaugini ji is 3, ir tai yra minimalus laiko tarpas kuri uztruksi, jeigu nesugebesi normaliai isaiskinti savo noru programuotojui. Kas tau pigiau - menuo ar minimum trys - jau spresti paciam.

 

* Antra, kam tau reikia funkcionalumo kurio pats nesupranti? Tai uzsakyk tik tai, ka pats suvoki. Jei reikes kazko daugiau, ir turesi suvokima kam tau to reikia ir kaip tai turi veikt - tai uzsakysi papildyma.

 

* Arba elementariai pakeisk poziuri - t.y. duok programuotojui pasireikst ir buk patenkintas tuo, ka gausi, be jokiu "as maniau", "as tikejausi" ir t.t.

Dėkui tau ir plx, mėginsiu rašyti.

Aš pašnekėsiu, kaip viskas atrodo iš programuotojo (asmeninės) pusės.

Aukščiau kažkas rašė pavyzdį su registracija, norėčiau papildyti.

Taigi, registracija. Nurodykite kokių duomenų reikalausite iš vartotojo, kokie bus neprivalomi. Būtų gerai, kad nurodytumėt, kokie simboliai leidžiami vartotojo varde, koks pastarųjų ilgių limitas ir pan. Programuotojui nebūtina nurodyti, kokius formatu duomenys saugomi, nebent yra specialus poreikis.

Na štai, užsiregistravome. Kokie registracijų limitai el. paštui, IP adresui? Ar reikalingas registracijos patvirtinimas. Jeigu taip - koks?

Pamiršome slaptažodį ar vartotojo vardą. Nuodugniai išdėstykite, ką tokiu atveju vartotojas turi daryti, kokius duomenis pateikti, kaip atgaus savo duomenis?

Užsiregistravome, tad prisijunkime. Kiek laiko galios sausainėlis? Ar patvirtinus prijungti automatiškai?

Ir tai yra tik kertiniai akmenys. Taip pat, bent man, svarbu, jeigu formoje yra klaidų, kokiu būdu apie jas bus pranešama vartotojui? Ar paprasčiausiu alert'u, ar užrašu virš laukelio su klaida, ar užrašu virš visos formos ar kuriuo nors iš daugelio kitų būdų?

Bet kokiu atveju, aiškinti reikia kuo plačiau, kadangi jei programuotojas nežinos, ką daryti toliau, jis vis tiek privalės kažką daryti (jeigu negali pasiklausti), nes deadline'as artėja. Tuomet jis pradeda daryti savaip arba tiesiog - kad veiktų.

Ir turėkit omeny čią A. Einšteno mintį: You do not really understand something unless you can explain it to your grandmother. Būtent taip aiškinkite programuotojams, dizaineriams ir kitiems, kurie daro darba jums. Tada nebus jokių nesusipratimų.

Aš pašnekėsiu, kaip viskas atrodo iš programuotojo (asmeninės) pusės.

 

Aukščiau kažkas rašė pavyzdį su registracija, norėčiau papildyti.

 

Taigi, registracija. Nurodykite kokių duomenų reikalausite iš vartotojo, kokie bus neprivalomi. Būtų gerai, kad nurodytumėt, kokie simboliai leidžiami vartotojo varde, koks pastarųjų ilgių limitas ir pan. Programuotojui nebūtina nurodyti, kokius formatu duomenys saugomi, nebent yra specialus poreikis.

 

Na štai, užsiregistravome. Kokie registracijų limitai el. paštui, IP adresui? Ar reikalingas registracijos patvirtinimas. Jeigu taip - koks?

 

Pamiršome slaptažodį ar vartotojo vardą. Nuodugniai išdėstykite, ką tokiu atveju vartotojas turi daryti, kokius duomenis pateikti, kaip atgaus savo duomenis?

 

Užsiregistravome, tad prisijunkime. Kiek laiko galios sausainėlis? Ar patvirtinus prijungti automatiškai?

 

Ir tai yra tik kertiniai akmenys. Taip pat, bent man, svarbu, jeigu formoje yra klaidų, kokiu būdu apie jas bus pranešama vartotojui? Ar paprasčiausiu alert'u, ar užrašu virš laukelio su klaida, ar užrašu virš visos formos ar kuriuo nors iš daugelio kitų būdų?

 

Bet kokiu atveju, aiškinti reikia kuo plačiau, kadangi jei programuotojas nežinos, ką daryti toliau, jis vis tiek privalės kažką daryti (jeigu negali pasiklausti), nes deadline'as artėja. Tuomet jis pradeda daryti savaip arba tiesiog - kad veiktų.

 

Ir turėkit omeny čią A. Einšteno mintį: You do not really understand something unless you can explain it to your grandmother. Būtent taip aiškinkite programuotojams, dizaineriams ir kitiems, kurie daro darba jums. Tada nebus jokių nesusipratimų.

Bet tai kiek reikia fantazijos turėti, viskam kam tu čia prirašei? Žmogus neturi nieko, jokio plano, net neisivaizduoja kaip kas atrodys, o mintyse susidelioti viską pradedant nuo neteisingo laukelio užpildymo perspėjimo, iki veikiančios gan sudėtingos sistemos, kurią padaryti funkcionalia ir prašoma programuotojo...

Tu pats tiki ką parašei?

Aš suprantu, kad jei nieko nepasakysi programuotojui, tai jis nieko ir nepadarys, bet iki tokio lygio...

Manau smulkmenas galima derinti atliekamo darbo metu, tai ką tu čia surašei - tavo svajonių užsakymas matyt. :)

Bet tai kiek reikia fantazijos turėti, viskam kam tu čia prirašei? Žmogus neturi nieko, jokio plano, net neisivaizduoja kaip kas atrodys, o mintyse susidelioti viską pradedant nuo neteisingo laukelio užpildymo perspėjimo, iki veikiančios gan sudėtingos sistemos, kurią padaryti funkcionalia ir prašoma programuotojo...

 

Tu pats tiki ką parašei?

 

Aš suprantu, kad jei nieko nepasakysi programuotojui, tai jis nieko ir nepadarys, bet iki tokio lygio...

 

Manau smulkmenas galima derinti atliekamo darbo metu, tai ką tu čia surašei - tavo svajonių užsakymas matyt. :)

O tu kam užduoti tokius klausimus, jei dabar kritikuoji kaip tau atsako kaip kas turi būti? Tu pats tiki ką tu klausinėji? Man rodos tu net neįsivaizduoji kaip yra sudėtinga viską atlikti be jokio sarašo

O tu kam užduoti tokius klausimus, jei dabar kritikuoji kaip tau atsako kaip kas turi būti? Tu pats tiki ką tu klausinėji? Man rodos tu net neįsivaizduoji kaip yra sudėtinga viską atlikti be jokio sarašo

Aš tik sakau, kad tokiem dalykam kaip - registracijos laukelis, leistini simboliai jame, YRA KAŽKOKS FORMATAS TAM, kad neaiškinti programuotojui kaip tai daryti ir kur dėlioti kablelius, jei nėra aprašyme, vadinasi 'darom standartu' kuris priklauso nuo programuotojo išsilavinimo lygio.

Aš tik sakau, kad tokiem dalykam kaip - registracijos laukelis, leistini simboliai jame, YRA KAŽKOKS FORMATAS TAM, kad neaiškinti programuotojui kaip tai daryti ir kur dėlioti kablelius, jei nėra aprašyme, vadinasi 'darom standartu' kuris priklauso nuo programuotojo išsilavinimo lygio.

o yra kur nors tavo "standartas" aprašytas, patentuotas ar kitaip įformintas?

o yra kur nors tavo "standartas" aprašytas, patentuotas ar kitaip įformintas?

Aš ne programuotojas, manau sveikai mastančio ir šiuo reikalu užsiimančio programuotojo smegenyse yra kažkokie mastymo standartai, kurie atliekami pagal programavimo ir saugumo standartus, ar tu programuoji iš lempos? ar vadovaujiesi taisyklėmis, ar kuri savo programavimo kalbą ir per stebuklą tavo užrašytą nesamone atvaizduoja visos naršyklės?

o yra kur nors tavo "standartas" aprašytas, patentuotas ar kitaip įformintas?

Standartų nėra, bet logiška, kad programuotojas žinos, kokius simbolius reikia isimti, kokius galima palikti. Tokie tie ir standartai