Fase attuale:
Finalizzazione del progetto. Consulta la cronologia.
Di seguito sono riportate alcune linee guida per aiutare le organizzazioni open source a collaborare in modo efficace con i redattori tecnici.
Presenta il redattore tecnico al mondo dell'open source e alla tua community
- Offri allo scrittore tecnico un "tour guidato" della tua community. Dove possono fare domande? A quali riunioni regolari deve partecipare o a quali mailing list deve iscriversi? Quali account sono necessari (GitHub, Discord, Slack)? Assicurati che comprendano il codice di condotta del progetto e sappiano come segnalare eventuali problemi. Assicurati che il tuo autore tecnico comprenda la licenza del progetto e rispetti gli eventuali requisiti di altri datori di lavoro in merito alla firma di CLA, DCO o altri contratti.
- Se possibile, presentagli alcune persone in fusi orari sovrapposti che possono rispondere rapidamente alle domande sulla community o sul progetto.
- Se puoi, inviagli dei gadget del progetto.
Aiuta il tecnico della scrittura a utilizzare gli strumenti e le procedure necessari per contribuire al tuo progetto
- Se le tue procedure non sono ben documentate, fissa un appuntamento per illustrare al Technical Writer il suo primo contributo, problema o pull request. Quali modelli o tag devono utilizzare? Chi deve esaminare il proprio contributo e come e quando deve seguire le revisioni? Se il loro lavoro include esempi di codice, come possono essere testati? Cosa devono sapere sulla tua procedura o sulle tue release CI/CD?
Aiuta il tecnico della scrittura a comprendere il progetto e i relativi utenti
- Spiega il progetto in dettaglio in modo che il tecnico redattore acquisisca una conoscenza concettuale solida del prodotto. In questo modo, il tecnico redattore può sentirsi più sicuro e autorevole nella scrittura del progetto.
- Descrivi le esigenze delle persone che utilizzano il progetto. Fornisci una descrizione il più specifica possibile: non solo "sviluppatori", ma "sviluppatori che creano siti web" e "sviluppatori che programmano robot industriali".
- Mettere il tecnico redattore in contatto con gli esperti in materia necessari. Ovvero gli sviluppatori o altri collaboratori del progetto responsabili degli aspetti del progetto che verranno trattati nella documentazione.
- Assicurati che il Technical Writer riceva il tempo e le risorse di cui ha bisogno dagli esperti della materia e da altri membri della community.
Fai domande.
- È possibile che la tua community o il tuo progetto non abbia mai collaborato con scrittori tecnici o collaboratori alla documentazione. Sfrutta l'opportunità di imparare contemporaneamente a condividere ciò che sai. Chiedi un feedback sulle tue procedure e sui tuoi strumenti: il tuo autore tecnico avrà probabilmente alcuni suggerimenti per il miglioramento.