Vinitor esiste dal 2021 — ma una vera documentazione finora non c’era. Chi voleva sapere come funzionava qualcosa ci scriveva o ci chiamava. Per uno strumento che i viticoltori usano nel vigneto — spesso con i guanti e con scarsa copertura — questa non è una buona soluzione.
Per questo abbiamo costruito docs.vinitor.app: una pagina di documentazione che spiega tutte le funzioni e aiuta a ogni domanda.
Perché una propria pagina di documentazione?
Vinitor è cresciuto negli anni — dalla semplice gestione delle attività a una piattaforma con difesa fitosanitaria, rilevazione presenze, sistema di autorizzazioni e vista mappa. Con ogni nuovo modulo diventava più difficile spiegare tutto solo tramite il supporto personale.
Una buona documentazione risolve più problemi contemporaneamente: i nuovi utenti si orientano più rapidamente, gli utenti esistenti scoprono funzioni che ancora non conoscevano, e il nostro team di supporto può rimandare a guide concrete invece di spiegare tutto singolarmente.
Cosa si trova lì?
I contenuti sono suddivisi in due aree:
Le Guide sono descrizioni passo passo per compiti concreti: creare un vigneto, creare un calendario dei trattamenti, invitare i collaboratori. Ogni guida mostra esattamente dove bisogna fare clic e cosa succede.
La Documentazione di riferimento descrive le funzioni in dettaglio: cosa fa il sistema di autorizzazioni, quali campi ha un vigneto, come funziona la rilevazione presenze via GPS? Qui c’è tutto ciò che serve per la consultazione.
A ciò si aggiunge una sezione Primi passi per l’ingresso: configurare l’azienda, installare l’app mobile, creare i primi vigneti.
Ricerca full-text
Tutti i contenuti sono raggiungibili tramite una ricerca full-text. Basta iniziare a digitare — i risultati compaiono immediatamente con anteprima ed evidenziazione delle corrispondenze. La ricerca funziona anche offline, perché l’indice di ricerca viene caricato insieme alla pagina. Così si trova rapidamente la guida giusta anche nel vigneto, senza una connessione internet stabile.
Video tutorial con doppiaggio IA
Per le guide più importanti sono disponibili brevi video tutorial che mostrano il flusso direttamente nella dashboard. I video non vengono registrati manualmente, ma generati automaticamente: uno script controlla il browser, esegue i passaggi e registra tutto.
Il doppiaggio è affidato a una voce generata dall’IA, basata sulla voce del fondatore Lukas Kurz. Quando l’interfaccia cambia, possiamo rigenerare il video in pochi minuti, senza allestire un microfono.
Al momento si tratta ancora di un esperimento. Stiamo verificando se questo formato faciliti davvero l’ingresso in Vinitor e come i video vengano accolti dai nostri utenti. La tecnologia che sta dietro è nuova e stiamo imparando anche noi — sia sulla qualità della voce sia sulla preparazione dei contenuti. Il feedback in merito lo accogliamo volentieri.
Pagina delle novità
Finora non esisteva un punto centrale in cui vedere cosa era cambiato in Vinitor. Questo cambia con la pagina delle novità: ogni aggiornamento vi compare in una linea temporale — con data, tag e una breve sintesi.
Per le funzioni più importanti sono inoltre disponibili articoli di blog dettagliati come questo. Lì descriviamo non solo cosa è nuovo, ma anche perché lo abbiamo costruito e come funziona a livello tecnico.
Come si prosegue?
La documentazione è da ora raggiungibile all’indirizzo docs.vinitor.app. La amplieremo di continuo — con nuove guide, video e pagine di riferimento.
A proposito: chi sfoglia con attenzione la documentazione delle attività scoprirà già in alcuni punti dei riferimenti a un nuovo sistema di attività. Non è un errore — la funzione è attualmente in fase di revisione finale e comparirà presumibilmente con la prossima release. Un piccolo assaggio, quindi.
Siamo lieti di ricevere riscontri — sulla documentazione, sui video o su Vinitor in generale.