L'équipe dont je fais partie fait actuellement l'expérience d'un roulement de personnel assez élevé, avec des membres qui évoluent généralement vers différents projets au sein d'une même entreprise. Actuellement, notre «formation» pour les nouveaux membres consiste à les jumeler avec un contact principal (généralement la personne la plus récente pour terminer leur formation) qui leur fournira une expérience pratique et demandera à des développeurs plus expérimentés si le nouveau recruteur demande quelque chose au mentor. ne sait pas. Cela permet au nouvel employé de s'impliquer rapidement et incite le mentor à améliorer également sa compréhension du système.
Cependant, comme vous pouvez l'imaginer, ce style de formation prend beaucoup de temps et n'offre pas un très bon transfert de connaissances (les idées fausses se propagent, les lacunes se creusent).
J'ai été chargé de générer de la documentation et du matériel de formation pour nos futures nouvelles recrues. Je fais déjà de la rédaction technique à l'occasion, mais c'est pour l'utilisateur final et est très spécifique avec beaucoup de captures d'écran et prend beaucoup de temps pour terminer.
La création de la nouvelle documentation pour les nouveaux employés est considérée comme une priorité faible et je n'ai actuellement que ~ 40 heures pour y travailler. Documenter le système de la façon dont j'écris actuellement la documentation technique rayerait à peine la surface en 40 heures. Surtout que je dois documenter non seulement sur la base de code, mais aussi sur les déploiements et le support.
Comment puis-je rédiger rapidement de la documentation pour mettre à jour les nouveaux employés le plus rapidement possible sans investir beaucoup de temps dans la rédaction de la documentation?
Informations supplémentaires:
Nous avons actuellement à la fois un wiki et une documentation de formation, mais les deux sont plutôt clairsemés.