A proposito di questo modello
Il modello Documentazione Tech è una lettera di presentazione disposta come una pagina di documentazione tecnica — sommario in rail sinistro, corpo a sinistra in Inter, riquadri tipo codice in JetBrains Mono e piè di pagina stile doc con tag di versione. Il formato riflette direttamente il mestiere: la lettera si legge come una pagina Mintlify, ReadMe o Docusaurus. Compatibile con gli ATS moderni (Greenhouse, Lever, Ashby); il rail sommario è puramente visivo.
Per quale profilo?
Si adatta ai technical writer (Associazione Italiana Documentazione tradizionale, autodidatti confermati), developer advocate, documentation engineer, product manager di piattaforme API (Translated API, Aindo API, Bending Spoons developer platform) e responsabili developer experience in SaaS B2B. La firma visiva dice immediatamente «conosco il mestiere della documentazione tech».
Come utilizzarlo
La lettera tech writing deve provare la padronanza degli strumenti e dei framework: Mintlify, ReadMe, Docusaurus, Hugo, MkDocs, OpenAPI/Swagger, JSON Schema. Citate due o tre documentazioni pubbliche che avete scritto o migliorato (con link pubblici). Menzionate il vostro approccio pedagogico (Diátaxis framework, Google Developer Documentation Style Guide, Microsoft Writing Style Guide). Per un developer advocate, aggiungete uno o due talk dati in conferenza riconosciuta (Codemotion Milano, DevDay Italia, JSConf Italy).
Domande frequenti
Bisogna padroneggiare il codice per essere technical writer?
Sì nel 90 % dei casi. Per scrivere documentazione API, bisogna saper leggere ed eseguire il codice in autonomia (JavaScript, Python, Go secondo lo stack). Per una documentazione prodotto pura (admin guide, knowledge base), la conoscenza codice può essere più leggera. Indicate il vostro livello reale su due o tre linguaggi — la precisione si legge positivamente.
Il formato doc è troppo niche per un grande gruppo?
Per una posizione di technical writer in un grande gruppo (Reply documentation, Engineering Ingegneria Informatica documentation, NTT Data Italia), il codice sembra nativo. Per una funzione RU trasversale in un grande gruppo non-tech, il codice può sembrare fuori tema. Adattate secondo lo scope tech della posizione.
Come evocare una migrazione di doc legacy?
È un soggetto apprezzato dai recruiter. Citate lo stack source (Confluence, MediaWiki, GitBook v1), lo stack target (Docusaurus, Mintlify, ReadMe v2), il volume migrato (numero di pagine, numero di autori), e la strategia (audit, deprecation, archiviazione, redirezioni SEO). Per una posizione senior tech writing, la padronanza delle migrazioni è segnale di seniority distintivo.
