La documentazione è l’altra metà di un tutorial
Alcune persone guardano, altre scorrono il testo, e i motori di ricerca indicizzano le parole. Produrre separatamente un video e una guida scritta significa scrivere due volte la stessa procedura. Capture comprende già il tuo tutorial abbastanza bene da ripulirne il voiceover, quindi la versione scritta nasce dallo stesso lavoro.
Come funziona Generate guide
- Modifica il tutorial come al solito. Tagli e rifiniture si riflettono nella guida.
- Clicca su Generate guide nell’editor. Se il progetto non ha ancora una trascrizione, Capture la crea prima.
- Capture scrive la guida a partire dalla trascrizione, preferendo il tuo voiceover ottimizzato, e dai tuoi clic: un titolo, un’introduzione e passaggi numerati.
- Ogni passaggio riceve uno screenshot dalla registrazione nel momento in cui hai cliccato, più un link per saltare a quel momento nel video.
Se in seguito cambi il montaggio, la guida viene segnalata come obsoleta. Rigenerala per riallinearla.
Come scrivere documentazione software quando preferiresti mostrarla
Chiedi a chiunque gestisca un centro assistenza cosa rende lenta la documentazione, e la risposta non sarà mai la digitazione. È decidere l’ordine dei passaggi, ricordarsi del prerequisito che dai per scontato e descrivere una schermata a memoria con abbastanza precisione perché un estraneo possa seguirla.
Mostrare l’attività risolve tutti e tre i problemi. Esegui i passaggi nell’ordine giusto perché è il prodotto a imporlo, il prerequisito compare perché lo fai davvero, e la schermata viene descritta con precisione perché la registrazione è la schermata. Poi modifichi una bozza invece di partire da una pagina bianca.
Una buona documentazione ha ancora bisogno di una persona che decida cosa conta. Solo che non ha bisogno di qualcuno che trascriva i propri clic.
Dove si colloca in Braiv Capture
Le guide sono una funzionalità complementare di Braiv Capture, basata sull’ottimizzazione del voiceover. Le guide vengono scritte nella lingua originale del tutorial. Per guide scritte a partire da video già presenti su YouTube, vedi da video YouTube ad articolo di supporto.
