Vinitor існує з 2021 року — але справжньої документації досі не було. Хто хотів дізнатися, як щось працює, писав нам або телефонував. Для інструмента, яким виноробі користуються у винограднику — часто в рукавицях і за поганого прийому, — це не найкраще рішення.
Тому ми побудували docs.vinitor.app: сторінку документації, яка пояснює всі функції й допомагає з будь-яким питанням.
Навіщо власна сторінка документації?
Vinitor виріс за роки — від простого керування завданнями до платформи із захистом рослин, обліком часу, системою дозволів і переглядом карти. З кожним новим модулем ставало дедалі важче пояснювати все лише через персональну підтримку.
Хороша документація вирішує кілька проблем водночас: нові користувачі швидше орієнтуються, наявні користувачі відкривають функції, яких ще не знали, а наша команда підтримки може посилатися на конкретні інструкції замість пояснювати все по одному.
Що там є?
Вміст поділено на два розділи:
Інструкції — це покрокові описи для конкретних завдань: створення виноградника, створення схеми захисту, запрошення працівників. Кожна інструкція показує точно, де треба клікнути й що станеться.
Довідкова документація детально описує функції: що робить система дозволів, які поля має виноградник, як працює GPS-облік часу? Тут є все, що потрібно для довідки.
До цього додається розділ «Перші кроки» для старту: налаштувати господарство, встановити мобільний застосунок, створити перші виноградники.
Повнотекстовий пошук
Увесь вміст доступний через повнотекстовий пошук. Просто почати вводити — результати зʼявляються одразу з попереднім переглядом і виділенням збігів. Пошук працює також офлайн, бо індекс пошуку завантажується разом зі сторінкою. Так навіть у винограднику без стабільного інтернету можна швидко знайти потрібну інструкцію.
Відеоуроки з ШІ-озвученням
Для найважливіших інструкцій є короткі відеоуроки, що показують процес безпосередньо на панелі керування. Відео не записуються вручну, а генеруються автоматично: скрипт керує браузером, виконує кроки й записує все.
Озвучення бере на себе ШІ-згенерований голос, що ґрунтується на голосі засновника Lukas Kurz. Якщо інтерфейс змінюється, ми можемо за кілька хвилин згенерувати відео заново, не налаштовуючи мікрофон.
Наразі це ще експеримент. Ми тестуємо, чи справді цей формат полегшує старт у Vinitor і як відео сприймають наші користувачі. Технологія за цим нова, і ми самі ще вчимося — як щодо якості голосу, так і щодо підготовки вмісту. Відгуки щодо цього ми охоче приймаємо.
Сторінка новин
Досі не було центрального місця, де можна було б побачити, що змінилося у Vinitor. Це змінюється зі сторінкою новин: кожне оновлення зʼявляється там на часовій шкалі — з датою, теґами та коротким описом.
Для більших функцій додатково є докладні дописи в блозі, як-от цей. Там ми описуємо не лише що нового, а й чому ми це побудували та як воно працює технічно.
Що далі?
Документація відтепер доступна за адресою docs.vinitor.app. Ми будемо постійно її розширювати — новими інструкціями, відео та довідковими сторінками.
До речі: хто уважно погортає документацію із завдань, уже подекуди помітить натяки на нову систему завдань. Це не помилка — функція саме на фінальній перевірці й, імовірно, зʼявиться з наступним релізом. Отже, невеликий передсмак.
Ми раді відгукам — щодо документації, відео чи Vinitor загалом.