Il team al momento faccio parte di un fatturato abbastanza elevato, con membri che generalmente si spostano su progetti diversi all'interno della stessa azienda. Attualmente la nostra "formazione" per i nuovi membri consiste nell'associarli a un contatto principale (di solito la persona più recente per completare la loro formazione) che fornirà loro esperienze pratiche e chiederà a sviluppatori senior se il nuovo assunto chiede qualcosa al mentore non lo so. Offre la possibilità al nuovo assunto di essere coinvolto rapidamente e sfida il mentore a migliorare anche la sua comprensione del sistema.
Tuttavia, come puoi immaginare, questo stile di allenamento richiede molto tempo e non fornisce un ottimo trasferimento di conoscenze (le idee sbagliate si propagano, le lacune si espandono).
Mi è stato affidato il compito di generare documentazione e materiale di formazione per i nostri nuovi assunti futuri. Di tanto in tanto scrivo anche di scrittura tecnica, ma è per l'utente finale ed è altamente specifico con molti screenshot e richiede molto tempo per il completamento.
La creazione della nuova documentazione per i nuovi assunti è considerata a bassa priorità e al momento ho solo ~ 40 ore per lavorarci. Documentare il sistema nel modo in cui scrivo la documentazione tecnica graffierebbe appena la superficie in 40 ore. Soprattutto considerando che devo documentare non solo la base di codice, ma anche le distribuzioni e il supporto.
Come posso scrivere rapidamente la documentazione per aggiornare i nuovi assunti il più rapidamente possibile senza investire tempo significativo nella stesura della documentazione?
Informazioni aggiuntive: al
momento disponiamo sia di un wiki, sia di documentazione sull'addestramento, tuttavia entrambi sono piuttosto radi.