Ragazzi, avete mai ascoltato un whitepaper? "White paper" è un termine che le persone con mentalità aziendale si troveranno a incontrare a un certo punto nelle loro carriere. Sia che sia serio o guidato dai meme, il white paper è diventato un elemento essenziale nell'industria crypto.

Anche gli investitori al dettaglio si sono abituati a rivedere i white paper prima di investire in un progetto crypto. Per molti progetti crypto oggi, il white paper è considerato da molti come la parte più importante del lancio. Il documento è l'unico requisito reale, anche prima di lanciare un sito web.

Ma cos'è un documento tecnico? Questo articolo risponde a questa domanda prima di trattare come scrivere un documento tecnico.

Cos'è un documento tecnico? Una definizione

I documenti tecnici esistono da circa 100 anni ed sono un'invenzione del governo britannico. Questi documenti informavano il pubblico sulle decisioni chiave prese da alcune agenzie governative.

Oggi, il documento tecnico è uno strumento di marketing utilizzato per persuadere e influenzare i decisori. Allora perché si chiama documento tecnico? È una designazione del governo britannico. Il colore "bianco" indica che il documento è disponibile per l'accesso pubblico.

Da allora, questo documento scientifico tradizionale è entrato nel dominio pubblico. Una volta che il documento è entrato nell'uso commerciale, il suo scopo era essere letto da qualsiasi potenziale cliente.

Questi documenti non sono presentazioni appariscenti né troppo di vendita. Piuttosto, il documento tecnico viene presentato come un documento "serio" simile a un documento scientifico. Allora, qual è lo scopo di un documento tecnico? Lo scopo originale del documento era educare. Oggi, questi documenti educano le persone sui prodotti e servizi del progetto.

Poiché i documenti tecnici vengono solitamente pubblicati su siti web, sono considerati una forma di marketing inbound. Nel marketing business-to-business (B2B), i documenti tecnici vengono utilizzati per vari scopi. Le aziende utilizzano documenti tecnici per raggiungere diversi obiettivi, come promuovere la leadership di pensiero e far crescere una lista email. I documenti tecnici vengono anche utilizzati per stabilire la legittimità del marchio e convertire potenziali clienti.

Questi documenti sono ancora prodotti dalle autorità governative. Tuttavia, il documento tecnico gode di un'ampia gamma di casi d'uso in tutti i domini pubblici e privati.

Prima di scrivere il documento tecnico

Molte persone cercano un modello di documento tecnico, ma i modelli non sono necessari. I modelli, in generale, fungono più da linee guida. Finché uno scrittore comprende la struttura di un documento tecnico e come tutte le sezioni lavorano insieme, il documento dovrebbe convincere il pubblico target riguardo al progetto in questione.

Il documento non deve essere lungo, ma non dovrebbe essere scritto come un post di blog. I post di blog tendono ad essere più brevi. Eppure, anche quelli più lunghi possono avere obiettivi che differiscono da quelli di un documento tecnico. Ad esempio, gli obiettivi di un documento tecnico includono la cura di un pubblico o l'invito ad iscriversi attivamente a un webinar.

Queste azioni non costano nulla al pubblico, quindi l'obiettivo della scrittura, e quindi il tipo di scrittura, differisce notevolmente. Al contrario, un pubblico di criptovalute che legge un documento deve essere persuaso ad acquistare una delle molte valute digitali per supportare il progetto.

Prima di scrivere una parola, o anche prima di eseguire la ricerca, lo scrittore deve identificare il pubblico target. In questo modo, lo scrittore può determinare rapidamente il linguaggio da utilizzare nel documento, così come la psiche del proprio pubblico. Questo approccio dovrebbe anche aiutare nella direzione della ricerca.

La ricerca è la pietra angolare di un grande documento tecnico. La ricerca include l'approfondimento nel team di progetto, gli aspetti tecnici del prodotto o servizio da offrire e perché è la migliore soluzione a un vecchio problema.

E poiché l'attenzione dei lettori è sui documenti tecnici delle criptovalute, non c'è margine di errore quando si tratta di scrivere sugli aspetti tecnici.

Cosa dovrebbe includere un documento tecnico?

Secondo l'autore di "Scrivere documenti tecnici" Michael Stelzner, il documento tecnico dovrebbe iniziare con un problema o una sfida che il lettore sta affrontando. Fare ciò è il modo più semplice per catturare l'attenzione del pubblico target e colpire i loro punti dolenti.

Una volta che stanno leggendo ulteriormente, l'obiettivo è presentare statistiche, diagrammi e fatti per sottolineare i punti principali del documento. Infine, il documento presenta la soluzione, che è il servizio o prodotto offerto dal team del progetto. Se l'autore ha prodotto un lavoro di qualità, allora la soluzione si collegherà bene al problema.

Una volta che la soluzione è stata presentata in modo convincente, il passo successivo è presentare il team. Questa sezione dovrebbe persuadere il lettore—senza ricorrere a un linguaggio di vendita—che il team è in grado di mantenere le promesse del progetto (cioè, la soluzione).

La sezione del team potrebbe includere foto reali, brevi biografie e link ai profili LinkedIn e Twitter. A volte, il team include NFT come foto del profilo, anche se questo potrebbe non essere il miglior approccio per guadagnare fiducia. Questi segnali di fiducia invitano il lettore a esplorare ulteriormente, mostrando allo stesso tempo che il team non ha nulla da nascondere.

In aggiunta a quanto sopra, il documento può presentare informazioni riguardanti il rilascio di token e considerazioni di mercato. Questo dovrebbe includere dettagli sui token crittografici, come il loro valore, il numero di token che saranno in circolazione e la piattaforma su cui saranno emessi.

Un altro elemento cruciale da includere è come prevedi di consentire agli investitori di riscattare i loro token e informazioni su cosa accadrà se il tuo metodo di raccolta fondi (come l'offerta iniziale di monete o ICO) non raggiunge i suoi obiettivi finanziari (processo di rimborso per gli investitori). I termini e le condizioni, o un link al tuo sito web dove possono scoprirli, dovrebbero essere inclusi anche in questa parte.

Infine, il documento può concludersi con una roadmap. La roadmap è solitamente suddivisa in obiettivi trimestrali. Questi obiettivi aiutano i lettori a legare ciò che hanno letto in precedenza nel documento, specificamente i problemi che saranno affrontati, con le soluzioni che il progetto fornirà.

Suddividendo la roadmap in questo modo, il documento aiuta il pubblico target a concettualizzare il progetto in una forma più tangibile. Una volta che il progetto viene lanciato, sia i lettori che gli investitori possono utilizzare la roadmap per monitorare se il team sta raggiungendo i propri obiettivi dichiarati.

Dall'altra parte, la roadmap aiuta a mantenere il team responsabile. Raggiungono i loro obiettivi dichiarati? Poiché il team sa che il pubblico sta osservando, mancare un obiettivo ha il potenziale di danneggiare la reputazione del progetto.

Formattazione e design dei documenti tecnici

Una volta che il documento tecnico è completo, la formattazione dovrebbe essere una priorità assoluta. La leggibilità viene trascurata in molti di questi documenti, rendendoli illeggibili.

Poiché l'adozione mainstream delle criptovalute sta avvenendo, è anche importante considerare i principianti nel pubblico. Le persone nuove nel settore delle criptovalute non conosceranno molti termini che sono ubiqui nel lessico delle criptovalute. È sempre meglio non presumere che il tuo pubblico target comprenda i termini e i concetti delle criptovalute quando scrivi per loro.

Un'altra considerazione di formattazione è lo spazio bianco. Alcuni documenti tecnici sono difficili da leggere perché la mancanza di spazio bianco sopraffà il lettore. (Leggi di più sullo spazio bianco qui.)

Gli scrittori dovrebbero confermare che ci sia abbastanza margine su tutti i lati. È importante prestare particolare attenzione allo spazio tra i paragrafi e altri elementi. Altri elementi possono includere grafici, illustrazioni e altri asset visivi che aiutano a sottolineare i punti principali.

Dando al lettore abbastanza spazio bianco, il documento li aiuta "a respirare" mentre si fermano e fanno una pausa prima di passare alla sezione successiva. Potrebbe sembrare controintuitivo, ma queste pause consentono ai lettori di digerire le informazioni e continuare a leggere fino alla fine.

Le decisioni di design non dovrebbero essere lasciate nemmeno ai capricci del team. Un documento eccezionale e ben scritto può vendere un progetto in modo indipendente, purché la tokenomics sia solida. Tuttavia, anche un tale documento trarrebbe beneficio se i suoi proprietari non trascurassero il suo design.

I designer grafici possono aiutare con le questioni di formattazione sopra descritte. Eppure, dove i designer lasciano il loro segno è assicurandosi che tutti gli elementi di design visivo siano allineati con il messaggio e l'identità del marchio. Farlo garantisce un'esperienza cliente fluida per il pubblico target.

Al contrario, scegliere di ignorare il design può comportare un'esperienza sgradevole. I lettori potrebbero anche avere difficoltà a ricordare quale azienda o marchio ha pubblicato il documento.

Un'esperienza cliente fluida è il motivo per cui le decisioni di design dovrebbero essere lasciate a un designer esperto. Un tale designer comprende l'identità del progetto, il suo pubblico target e gli obiettivi chiave. Inoltre, il designer può collaborare con lo scrittore per verificare che tutti gli elementi siano correlati e abbiano senso.

Quando contenuti ed elementi visivi si completano a vicenda, migliorano le loro qualità, garantendo così un'esperienza olistica.

Due famosi esempi di documenti tecnici per ispirazione

Questa sezione esamina due dei più citati esempi di documenti tecnici nel settore delle criptovalute: il documento tecnico di Bitcoin e il documento tecnico di Ethereum.

Il documento tecnico di Bitcoin non è un "documento tecnico" nel senso tradizionale, ed è un termine improprio. Ciò che l'autore anonimo Satoshi Nakamoto ha scritto è un documento accademico. Gli utenti possono leggere il documento originale qui.

Al contrario, il documento tecnico di Ethereum è più un documento tecnico. Il documento di Ethereum si discosta dal formato di studio tradizionale. È trattato più come un documento vivente che viene modificato e migliorato nel tempo con addendum.

Ecco perché il documento su Ethereum è passato dall'essere un documento tecnico a qualcosa di più simile a un manuale utente di riferimento o documentazione tecnica. Il documento tecnico di Ethereum (scritto "whitepaper" in questo caso) è disponibile per intero qui.

Come ottenere un documento tecnico senza scriverne uno

Se un imprenditore non ha il tempo o le competenze necessarie per scrivere un documento tecnico, può sempre assumere uno scrittore. Molti scrittori professionisti si specializzano nella scrittura di documenti tecnici. Non manca mai un'ottima scrittura di documenti tecnici disponibile per l'assunzione.

È anche una considerazione extra per coloro che lavorano nel settore delle criptovalute. Alcuni ingegneri e programmatori hanno difficoltà a scrivere per il loro pubblico in modo relazionabile.

Gli scrittori di documenti tecnici possono costare molto di più rispetto ai liberi professionisti trovati su piattaforme come Fiverr e Upwork. Tuttavia, l'investimento è necessario e prudente. Un ottimo documento renderà il lavoro di un team di progetto molto più facile.

Specificamente—e soprattutto, un documento tecnico convincente rende più facile generare interesse. Generare interesse rende più facile raccogliere fondi, indipendentemente dal modello di lancio scelto dal progetto crittografico.

Un progetto può scegliere di optare per un'offerta iniziale di partecipazione (ISO), o anche un approccio più tradizionale e favorevole alla finanza come un'offerta pubblica iniziale (IPO) o finanziamenti di venture capital. Non importa. Un documento tecnico servirà bene ogni progetto serio.

\u003ct-103/\u003e\u003ct-104/\u003e\u003ct-105/\u003e\u003ct-106/\u003e\u003ct-107/\u003e