Vinitor obstaja od leta 2021 — a prave dokumentacije doslej ni bilo. Kdor je hotel vedeti, kako kaj deluje, nam je pisal ali telefoniral. Pri orodju, ki ga vinogradniki uporabljajo v vinogradu — pogosto z rokavicami in ob slabem sprejemu — to ni dobra rešitev.
Zato smo zgradili docs.vinitor.app: stran z dokumentacijo, ki pojasnjuje vse funkcije in pomaga pri vsakem vprašanju.
Zakaj lastna stran z dokumentacijo?
Vinitor je skozi leta rasel — od preprostega upravljanja opravil do platforme z varstvom rastlin, evidenco časa, sistemom dovoljenj in prikazom zemljevida. Z vsakim novim modulom je bilo težje vse pojasniti le prek osebne podpore.
Dobra dokumentacija hkrati reši več težav: novi uporabniki se hitreje znajdejo, obstoječi uporabniki odkrijejo funkcije, ki jih še niso poznali, naša ekipa za podporo pa lahko napoti na konkretna navodila, namesto da vse pojasnjuje posebej.
Kaj je tam na voljo?
Vsebine so razdeljene na dva dela:
Navodila so opisi po korakih za konkretna opravila: ustvarjanje vinograda, ustvarjanje načrta škropljenja, vabljenje delavcev. Vsako navodilo natančno prikaže, kje je treba klikniti in kaj se zgodi.
Referenčna dokumentacija funkcije opisuje podrobno: kaj počne sistem dovoljenj, katera polja ima vinograd, kako deluje evidenca časa prek GPS? Tu je vse, kar potrebuješ za iskanje.
K temu pride razdelek Prvi koraki za vstop: nastavi podjetje, namesti mobilno aplikacijo, ustvari prve vinograde.
Celobesedilno iskanje
Vse vsebine so dosegljive prek celobesedilnega iskanja. Preprosto začni tipkati — rezultati se pojavijo takoj s predogledom in poudarjanjem zadetkov. Iskanje deluje tudi brez povezave, ker se indeks iskanja naloži skupaj s stranjo. Tako tudi v vinogradu brez stabilnega interneta hitro najdeš pravo navodilo.
Videovodiči z ozvočenjem UI
Za najpomembnejša navodila so na voljo kratki videovodiči, ki potek prikažejo neposredno na nadzorni plošči. Videoposnetki se ne snemajo ročno, temveč se ustvarjajo samodejno: skript krmili brskalnik, izvaja korake in vse posname.
Ozvočenje prevzame z UI ustvarjeni glas, ki temelji na glasu ustanovitelja Lukasa Kurza. Ko se vmesnik spremeni, lahko video v nekaj minutah ustvarimo znova, ne da bi postavljali mikrofon.
Trenutno je to še poskus. Preizkušamo, ali ta oblika resnično olajša vstop v Vinitor in kako videoposnetke sprejmejo naši uporabniki. Tehnika za tem je nova in tudi sami se še učimo — tako pri kakovosti glasu kot pri pripravi vsebin. Povratne informacije o tem z veseljem sprejmemo.
Stran z novicami
Doslej ni bilo osrednjega mesta, kjer bi bilo mogoče videti, kaj se je v Vinitorju spremenilo. To se spreminja s stranjo z novicami: vsaka posodobitev se tam pojavi v časovnici — z datumom, oznakami in kratkim povzetkom.
Za večje funkcije so poleg tega na voljo izčrpne objave na blogu, kot je ta tukaj. Tam ne opisujemo le, kaj je novega, temveč tudi, zakaj smo to zgradili in kako tehnično deluje.
Kako naprej?
Dokumentacija je odslej dosegljiva na naslovu docs.vinitor.app. Nenehno jo bomo širili — z novimi navodili, videoposnetki in referenčnimi stranmi.
Mimogrede: kdor pozorno prelistuje dokumentacijo opravil, bo ponekod že opazil namige na nov sistem opravil. To ni napaka — funkcija je ravno v končnem pregledu in bo predvidoma izšla z naslednjo izdajo. Torej majhen predokus.
Veseli smo povratnih informacij — o dokumentaciji, o videoposnetkih ali o Vinitorju na splošno.