O Vinitor existe desde 2021 — mas até agora não havia uma documentação a sério. Quem quisesse saber como algo funciona escrevia-nos ou ligava. Para uma ferramenta que os viticultores usam na vinha — muitas vezes com luvas e com má receção — isso não é uma boa solução.
Por isso construímos o docs.vinitor.app: uma página de documentação que explica todas as funcionalidades e ajuda com qualquer dúvida.
Porquê uma página de documentação própria?
O Vinitor cresceu ao longo dos anos — de uma simples gestão de tarefas para uma plataforma com proteção fitossanitária, registo de tempo, sistema de permissões e vista de mapa. A cada novo módulo, tornava-se mais difícil explicar tudo apenas através de apoio pessoal.
Uma boa documentação resolve vários problemas ao mesmo tempo: os novos utilizadores orientam-se mais depressa, os utilizadores existentes descobrem funcionalidades que ainda não conheciam, e a nossa equipa de apoio pode remeter para guias concretos, em vez de explicar tudo individualmente.
O que há lá?
O conteúdo está dividido em duas áreas:
Os guias são descrições passo a passo para tarefas concretas: criar uma vinha, criar um calendário de tratamentos, convidar funcionários. Cada guia mostra exatamente onde clicar e o que acontece.
A documentação de referência descreve as funcionalidades em detalhe: o que faz o sistema de permissões, que campos tem uma vinha, como funciona o registo de tempo GPS? Aqui está tudo o que se precisa para consultar.
A isto junta-se uma área de primeiros passos para a entrada: configurar a exploração, instalar a aplicação móvel, criar as primeiras vinhas.
Pesquisa de texto integral
Todo o conteúdo é acessível através de uma pesquisa de texto integral. Basta começar a escrever — os resultados aparecem de imediato, com pré-visualização e destaque dos resultados. A pesquisa também funciona offline, porque o índice de pesquisa é carregado junto com a página. Assim, encontra-se rapidamente o guia certo mesmo na vinha, sem uma ligação à Internet estável.
Tutoriais em vídeo com narração por IA
Para os guias mais importantes há tutoriais em vídeo curtos, que mostram o processo diretamente no dashboard. Os vídeos não são gravados manualmente, mas gerados automaticamente: um script controla o navegador, executa os passos e grava tudo.
A narração é feita por uma voz gerada por IA, baseada na voz do fundador Lukas Kurz. Quando a interface muda, podemos regenerar o vídeo em minutos, sem montar um microfone.
Isto é atualmente ainda uma experiência. Estamos a testar se este formato facilita realmente a entrada no Vinitor e como os vídeos são recebidos pelos nossos utilizadores. A tecnologia por trás disto é nova e nós próprios ainda estamos a aprender — tanto na qualidade da voz como no tratamento dos conteúdos. Aceitamos os comentários com todo o gosto.
Página de novidades
Até agora não havia um local central onde se pudesse ver o que mudou no Vinitor. Isso muda com a página de novidades: cada atualização aparece aí numa linha temporal — com data, etiquetas e um breve resumo.
Para funcionalidades maiores há, além disso, publicações de blogue detalhadas como esta. Aí descrevemos não só o que é novo, mas também porque o construímos e como funciona tecnicamente.
Como continua?
A documentação está disponível a partir de agora em docs.vinitor.app. Vamos continuar a expandi-la — com novos guias, vídeos e páginas de referência.
Já agora: quem folhear com atenção a documentação de tarefas vai encontrar, em alguns pontos, indícios de um novo sistema de tarefas. Isso não é um erro — a funcionalidade está atualmente na revisão final e deverá aparecer com o próximo lançamento. Uma pequena antevisão, portanto.
Ficamos contentes com os comentários — sobre a documentação, sobre os vídeos, ou sobre o Vinitor em geral.