Vinitor съществува от 2021 г. — но истинска документация досега нямаше. Който искаше да разбере как работи нещо, ни пишеше или се обаждаше. При инструмент, който винарите използват в лозето — често с ръкавици и при лош прием — това не е добро решение.
Затова изградихме docs.vinitor.app: страница с документация, която обяснява всички функции и помага при всеки въпрос.
Защо собствена страница с документация?
Vinitor нарасна през годините — от простото управление на задачи до платформа с растителна защита, отчитане на времето, система за права и изглед на картата. С всеки нов модул ставаше по-трудно всичко да се обяснява само чрез лична поддръжка.
Добрата документация решава няколко проблема едновременно: новите потребители се ориентират по-бързо, съществуващите потребители откриват функции, които още не са познавали, а нашият екип за поддръжка може да препраща към конкретни ръководства, вместо да обяснява всичко поотделно.
Какво има там?
Съдържанията са разделени на две области:
Ръководствата са описания стъпка по стъпка за конкретни задачи: създаване на лозе, създаване на план за пръскане, канене на служители. Всяко ръководство показва точно къде трябва да се кликне и какво се случва.
Референтната документация описва функциите в детайли: какво прави системата за права, какви полета има едно лозе, как работи GPS отчитането на времето? Тук е всичко, което е нужно за справка.
Към това идва област Първи стъпки за навлизането: настройка на стопанството, инсталиране на мобилното приложение, създаване на първите лозя.
Пълнотекстово търсене
Всички съдържания са достъпни чрез пълнотекстово търсене. Просто започни да пишеш — резултатите се появяват веднага с визуализация и открояване на съвпаденията. Търсенето работи и офлайн, защото индексът за търсене се зарежда заедно със страницата. Така и в лозето без стабилен интернет бързо се намира правилното ръководство.
Видео уроци с озвучаване с ИИ
За най-важните ръководства има кратки видео уроци, които показват процеса директно в таблото. Видеата не се записват ръчно, а се генерират автоматично: скрипт управлява браузъра, изпълнява стъпките и записва всичко.
Озвучаването се поема от генериран с ИИ глас, който се основава на гласа на основателя Lukas Kurz. Когато интерфейсът се промени, можем да генерираме видеото наново за минути, без да настройваме микрофон.
Това засега е още експеримент. Тестваме дали този формат наистина улеснява навлизането във Vinitor и как видеата се приемат от нашите потребители. Технологията зад това е нова и самите ние още се учим — както за качеството на гласа, така и за подготовката на съдържанията. Обратната връзка по темата приемаме с радост.
Страница с новини
Досега нямаше централно място, на което да се види какво се е променило във Vinitor. Това се променя със страницата с новини: всяка актуализация се появява там в една времева линия — с дата, тагове и кратко резюме.
За по-големите функции има допълнително подробни публикации в блога като тази тук. Там описваме не само какво е ново, но и защо сме го изградили и как функционира технически.
Как продължаваме нататък?
Документацията е достъпна от сега нататък на docs.vinitor.app. Ще я разширяваме постоянно — с нови ръководства, видеа и референтни страници.
Между другото: който прелиства внимателно документацията за задачите, ще открие на някои места вече указания за нова система за задачи. Това не е грешка — функцията в момента се намира в финална проверка и вероятно ще се появи със следващата версия. Малка предварителна дегустация, така да се каже.
Радваме се на обратна връзка — за документацията, за видеата или за Vinitor като цяло.