Une page ne montre pas toute la compétence
Un article soigné prouve que vous pouvez écrire un texte soigné. Il ne montre pas comment vous avez découvert l’information manquante, choisi l’audience, géré des exigences contradictoires ou vérifié les instructions.
Transformez chaque exemple en petite case study.
Expliquez d’abord le problème
Indiquez qui était le lecteur, ce qu’il devait accomplir et quelles contraintes existaient : comportement incomplet, plusieurs versions, délai de release, terminologie réglementée ou migration difficile.
Montrez ensuite ce que vous avez changé et pourquoi. Un avant/après de la structure peut être plus parlant qu’un screenshot final.
Diversifiez les preuves
Un exemple peut être une procédure, un autre une API reference, un autre une architecture de l’information ou une automatisation de qualité. Si le travail propriétaire ne peut être publié, recréez le problème avec un produit public ou anonymisez-le correctement.
Montrez la vérification
Expliquez comment vous avez testé commands, validé examples et travaillé avec des subject-matter experts. Ne revendiquez pas d’impact business sans preuve.
Facilitez le review
Trois case studies fortes valent souvent mieux que vingt liens sans contexte. Résumez chacune, donnez un accès rapide à l’artefact et vérifiez links, images et permissions.
Le portfolio doit répondre à une question pratique : quel problème de documentation cette personne peut-elle résoudre avec nous ?
Exemple pratique
Transformez « Un portfolio de technical writing doit montrer des décisions, pas seulement des pages » en exercice court avec un résultat observable. Choisissez un artefact réalisable en une ou deux sessions : procédure d’une page, exemple API, édition avant/après, nettoyage terminologique ou petit cas de portfolio. Définissez avant de commencer ce que signifie « mieux ».
Conservez les preuves du travail :
- problème et audience d’origine ;
- décisions prises et alternatives rejetées ;
- retour d’un lecteur, relecteur ou expert ;
- une chose à changer lors de la prochaine tentative.
Cela apprend plus que l’accumulation passive de cours. La rédaction technique est un métier de décisions répétées sous contraintes ; un petit exercice terminé et réellement relu vaut davantage qu’un grand projet théorique jamais lu.
Checklist éditorial rapide
- Une page ne montre pas toute la compétence. Un article soigné prouve que vous pouvez écrire un texte soigné.
- Expliquez d’abord le problème. Indiquez qui était le lecteur, ce qu’il devait accomplir et quelles contraintes existaient : comportement incomplet, plusieurs versions, délai de release, terminologie réglementée ou migration difficile.
- Diversifiez les preuves. Un exemple peut être une procédure, un autre une API reference, un autre une architecture de l’information ou une automatisation de qualité.
- Montrez la vérification. Expliquez comment vous avez testé commands, validé examples et travaillé avec des subject-matter experts.
