Question:
Mon employeur veut que je rédige un guide pour faire mon travail
thanby
2014-09-18 01:35:49 UTC
view on stackexchange narkive permalink

Je suis sur le point de quitter une entreprise et j'effectue un travail technique pour une PME (petite ou moyenne entreprise) et je suis le seul expert de diverses parties de l'exploitation de l'entreprise. J'ai acquis ces connaissances grâce à une combinaison d'école, de formation et d'expérience.

Mon patron m'a maintenant demandé de rédiger un guide étape par étape pour effectuer une grande partie du travail de maintenance qui se déroule quotidiennement, probablement pour qu'il puisse transmettre les responsabilités à un service d'assistance médiocre technicien ou autre employé qui ne sait pas comment faire quoi que ce soit. Ce sont des choses qui devraient vraiment être faites par quelqu'un qui est qualifié, car non seulement elles sont compliquées (et potentiellement dangereuses si elles ne sont pas bien faites), mais il existe des domaines de carrière entiers basés sur exactement cela.

Il est clair qu'il n'envisage pas d'embaucher quelqu'un pour me remplacer dans ces tâches, et je l'ai déjà prévenu à plusieurs reprises que c'est une mauvaise idée d'essayer de couper les coins ronds comme ça ou simplement d'espérer que ça marche , mais en vain.

Je ne suis pas vraiment d'accord pour brûler des ponts malgré le fait que je n'en ai peut-être plus jamais besoin.

Suis-je obligé d'écrire le guide sur "Comment faire mon travail »ou est-ce que cela demande quelque chose de déraisonnable? Gardez à l'esprit que nous ne parlons pas de simples correctifs ou de notes, nous faisons référence à l'ensemble des routines de maintenance et de mise à jour des logiciels hébergés pour les clients.

Êtes-vous d'accord pour brûler des ponts et ne pas être réembauché dans cette entreprise? Vous devriez l'inclure dans la question, car cela pourrait avoir un impact sur les réponses.
en relation: [Comment puis-je me préparer à être frappé par un bus?] (http://workplace.stackexchange.com/questions/9128/how-can-i-prepare-for-getting-hit-by-a-bus)
@ChrisLively et thanby, je suis d'accord, l'idée générale est de brûler des ponts ne va pas. Nous sommes tous trois sur la même longueur d'onde ici, mais je ne demande pas pour moi mais pour m'assurer que nous obtenons les meilleures réponses possibles ici, des réponses qui ne font pas de fausses hypothèses sur vos objectifs. J'espère que cela aide à clarifier. En passant, j'ai édité votre commentaire dans le post.
Sept réponses:
David K
2014-09-18 01:43:07 UTC
view on stackexchange narkive permalink

Tant que vous êtes encore employé dans cette entreprise, vous êtes obligé d'assumer les responsabilités du poste. Si votre patron vous dit qu'il souhaite que vous écriviez ce guide, vous devriez le faire au mieux de vos capacités. Vous lui avez déjà dit qu'il avait besoin d'une personne formée pour faire le travail, et c'est à lui de décider s'il veut ou non écouter vos conseils. Vous allez bientôt partir, à quel point ce ne sera plus votre problème à vous soucier!

Tirant quelques bons conseils des commentaires:

Cela vaut la peine d'être noté tout ce qui est particulièrement «à haut risque» dans votre guide doit le mentionner spécifiquement. Pour une personne non formée, c'est presque un jeu de dragueur de mines. (seulement avec leur réputation et peut-être leur travail en jeu) Ce n'est pas de leur faute si votre patron les a effectivement mis en échec, mais vous pouvez au moins améliorer leurs chances de réussite. "Vous voyez ce paramètre ici? Ouais celui-là ... Ne le définissez jamais sur tous les jours ... Si vous le faites, le serveur maximisera son disque dur pendant la nuit, avant de ne pas vous laisser essayer de restaurer une sauvegarde coûtant des centaines de dollars à l'entreprise. des milliers de dollars ... Bonne chance! " - RualStorge

Dans les endroits qui, selon vous, nécessitent un expert hautement qualifié, écrivez simplement "ce travail devrait être laissé à un expert formé en X, Y et Z". Ou "si X se produit, trouvez un expert qualifié". - gnasher729

@RualStorge: est encore pire lorsque le système considéré est fondamentalement indiscipliné, de sorte qu'il n'est pas possible de répertorier tous les pièges de ce type. Fondamentalement, il y a une raison pour laquelle un chirurgien du cerveau ne peut pas simplement écrire un guide «Comment faire mon travail» et le remettre à un employé au salaire minimum dans la rue, et une partie (certes pas la totalité) de cette raison est de gérer raisonnablement une myriade de choses qui peuvent mal tourner d'une manière subtilement différente de * toutes * les façons dont cela s'est mal passé auparavant.
La première étape consistera-t-elle à passer 3 ans à l'université, à des cours de formation, etc.? C'est dommage de voir cela être tellement voté alors que pour la plupart des rôles techniques, il devrait être impossible de résumer en étapes simples. La documentation de votre implémentation spécifique devrait idéalement avoir été faite au fur et à mesure, un transfert n'est réaliste que pour une personne ayant des compétences de base dans les technologies que vous avez utilisées. Bien que vous ayez à faire ce qu'on vous demande, si la tâche est annulable, il vous incombe tout autant de le souligner.
Les chirurgiens du cerveau d'@SteveJessop * font * certainement * rédiger des guides «comment faire mon travail» et les procédures exactes à suivre dans certaines manipulations - documentant les meilleures pratiques, les résultats de l'expérience, les pièges probables, et aussi une liste [de contrôle] ordonnée pour tous les choses insignifiantes qu'il ne faut pas oublier. Cela ne veut pas dire que je peux faire une chirurgie cérébrale en lisant la documentation; mais cela sera très utile pour un chirurgien du cerveau qualifié qui effectue cette procédure particulière pour la première fois (c'est ainsi que de nouvelles procédures se répandent dans le monde), et la même chose peut être faite en informatique.
@JamesRyan Vous pouvez écrire des guides même pour les choses les plus techniques en mode maintenance, et tant que tout fonctionne comme il se doit, le guide restera vrai. (c'est ce que le PO devrait écrire) comment réagir quand les choses ne se passent pas comme prévu, eh bien c'est là qu'un diplôme est nécessaire. (Cas et argument, vous pouvez apprendre à n'importe qui à maintenir un système de filtration d'eau établi, des filtres à reflux lorsque X se produit, l'ajout de produit chimique Y lorsque l'eau indique une lecture de Z, etc.) Mais lorsque l'eau est contaminée ou qu'un système tombe en panne ... lorsque la personne mal formée est complètement vissée.
Les systèmes informatiques d'@RualStorge visent à gérer le changement. Il est extrêmement rare que quoi que ce soit puisse être maintenu tel quel pendant très longtemps.
Tout le monde ici a raison dans une certaine mesure. La documentation que j'ai conservée est conforme aux normes de l'industrie, destinée à être lue par quelqu'un d'autre dans un rôle équivalent, mais serait très déroutante pour quelqu'un qui ne sait même pas ce qu'est un compilateur, et encore moins comment créer des applications Web avec il. JamesRyan est très correct avec le dernier commentaire. Les situations inattendues sont la norme et «maintenance» ne veut pas dire «statique».
@Peteris: bien sûr, mais la prémisse de la question est que la personne suivante * n'est pas un chirurgien du cerveau * et n'est pas qualifiée pour suivre les instructions pour la chirurgie du cerveau. Il est juste plus facile (j'espère) de voir le problème dans mon analogie, car il n'y a presque rien * qu'une personne non formée peut faire en chirurgie, alors qu'en informatique beaucoup de procédures peuvent vraiment être documentées pour les nuls avec quelques "ici des avertissements de dragons. Cela ne devrait pas détourner l'attention de la prémisse que le travail de l'interrogateur ne fait pas partie de ces cas relativement faciles.
Cela ne s'appliquerait que si une telle tâche était indiquée dans la description de poste. S'il ne dit rien sur la rédaction d'un tel guide, il n'y a aucune obligation de le faire.
Vous êtes également obligé de faire ce que vous jugez moralement juste, et il est courageux de nier une responsabilité professionnelle au nom de faire quelque chose de moral. Dans ce cas, il semble que le refus d'être complice du guide pratique du patron serait un choix éthique louable, alors que d'accepter de le compléter simplement parce que le patron a demandé, puis de le rationaliser comme faisant inévitablement partie du tâches professionnelles, serait un choix contraire à l'éthique. Tout comme d'autres ont demandé si brûler des ponts vous convient, il est également important pour nous de savoir si agir de manière contraire à l'éthique est acceptable pour vous.
@EMS: Je ne vois absolument rien de contraire à l'éthique dans la rédaction d'un guide pratique pour certaines parties de votre travail, et il se peut même qu'il n'y ait rien de mal éthique à faire faire le travail par une personne non qualifiée. C'est simplement une mauvaise pratique commerciale, et c'est donc la responsabilité de la personne qui dirige l'entreprise. Si cette personne veut faire un mauvais choix, vous devez la déconseiller (ce que l'OP a fait) et donner suite à sa décision finale.
@David K - Et si vous croyez qu'à la suite de la rédaction du guide, que vous savez que le responsable utilisera à tort ou à raison pour faire travailler des personnes non qualifiées, ce mal pourrait arriver à quelqu'un? Peut-être un préjudice financier parce que l'entreprise fonctionnera moins efficacement et perdra des clients? Peut-être un préjudice à l'emploi si ces personnes non qualifiées peuvent être licenciées et licenciées, ou même des blessures physiques s'il s'agit d'un processus de travail physique qui nécessite une expertise pour fonctionner en toute sécurité? Tout ce fil me rappelle la façon dont les gens ont rationalisé les actions dans l'épisode de la Nuclear Regulatory Commission de Moral Mazes
Aaron Hall
2014-09-18 04:46:40 UTC
view on stackexchange narkive permalink

Il semble que votre entreprise présente de réels risques pour les hommes clés. Vous devez absolument faire comme demandé. Document, document, document.

Commencez par un aperçu des principaux sujets que vous devriez aborder, et faites-en part à votre patron.

Créez ensuite un aperçu de chaque sujet. Ne vous inquiétez pas des phrases complètes lorsque vous listez des articles, obtenez simplement les idées de base et les étapes. Faites ceci dans l'ordre d'importance (les choses les plus importantes en premier!)

Avez-vous terminé? Vous y travaillez toujours? Passez en revue avec votre patron et / ou vos remplaçants (espérons qu'ils se chevauchent avec votre mandat afin que vous puissiez passer en douceur). Découvrez ce qui n'est pas clair pour eux et écrivez-le plus en détail et avec plus de clarté. Expliquez les choses que vous pensiez évidentes mais qu'elles n'ont pas obtenues.

Revoyez votre plan principal, avez-vous oublié quelque chose? Ajoutez-le. Y a-t-il un sujet particulièrement déroutant qu'ils semblent simplement ne pas saisir? Écrivez-le d'une manière différente.

C'est fait? Sauvegardez-le à plusieurs endroits et imprimez quelques copies papier à stocker dans des endroits séparés, et demandez à l'emporter avec vous pour référence future. Je vois de gros frais de consultation dans votre avenir s'ils s'étouffent avec cela.

«Emportez-le avec vous pour référence future» peut être illégal. Laissez la documentation à votre employeur, ainsi que vos coordonnées. S'ils vous appellent pour une consultation, ils devraient avoir la documentation qui vous attend.
@StephanKolassa C'est pourquoi il a écrit "demandez à l'emporter avec vous" ...
D'accord. La connaissance dans la tête de quelqu'un n'est pas sûre - que cette personne y travaille ou non. Un accident et vous avez perdu la connaissance! Il est plus que juste pour un employeur d'exiger que les connaissances soient entrées dans une sorte de base de connaissances. Cependant, il est également juste que la base de connaissances soit pertinente pour le public. Si la procédure X a besoin d'un ingénieur qualifié, alors écrivez la base de connaissances de telle sorte qu'elle ne soit pas utile à quelqu'un sans qualification, ainsi qu'en indiquant «Cette procédure nécessite cette qualification».
@GreenstoneWalker Ce serait plutôt "n'écrivez pas délibérément la base de connaissances de telle sorte que quelqu'un sans qualification puisse l'utiliser, si cela compromet la capacité d'une personne possédant la qualification à l'utiliser efficacement". Il n'est pas nécessaire de rendre * délibérément * les choses plus compliquées qu'elles ne devraient l'être. Il est nécessaire d'être suffisamment précis pour que quelqu'un qui sait ce qu'il fait puisse exécuter correctement la procédure.
Par exemple, si j'écris un guide sur la façon de configurer un environnement de développement pour un produit, je vais supposer que je suis familiarisé avec les outils de développement (donc dans le cas de Visual Studio, par exemple, je peux écrire "allez dans Team Explorer et cliquez le bouton de la barre d'outils X "ou" ouvrez config.xml et définissez root / config / path sur le chemin racine du code source "), mais cela signifie simplement que quelqu'un qui n'est pas familier avec les outils de développement devra faire beaucoup plus de recherches pour trouver les pièces dont ils ont besoin pour suivre le guide. Assez souvent, cela peut suffire, si cela est convenu comme un bon résultat de la rédaction du guide.
teego1967
2014-09-18 02:27:48 UTC
view on stackexchange narkive permalink

C'est tout à fait normal de faire ce genre de choses quand on a annoncé son départ. Prenez simplement le temps et soyez aussi gentil que possible. Pas besoin de travailler de longues heures.

Ce n'est vraiment pas votre problème de savoir comment ils vont trouver une personne qualifiée pour faire le travail. Il se pourrait très bien que votre vacance d'emploi soit la grande rupture d'un technicien du service d'assistance. Les meilleures opportunités viennent aux personnes qui sont, du moins sur le papier, malheureusement sous-qualifiées.

Cela dit, certaines activités sont probablement mieux documentées avec un screencast de 10 minutes qu'un mur de texte. Si vous voulez être super gentil à ce sujet, demandez exactement ce que les gens veulent documenter.

@Myles: Créer une archive vidéo sur la façon de vous externaliser et attribuer implicitement les droits d'auteur à votre futur ancien employeur, à moins que cela n'ait été accepté comme l'une de vos tâches professionnelles, est vraiment fou (et si l'employeur se retourne et revend ou autorise cette vidéo?). Le PO ferait mieux de négocier une formation continue ou un taux de soutien après leur départ, sur une base horaire et sous réserve de disponibilité.
@smci C'est une partie standard des emplois de nombreuses personnes.
@jwg: ce n'est * pas * une partie standard des emplois de la plupart des gens. Tout peut être négocié. Réduire votre valeur marchande sans contrepartie est fou. Former un remplaçant est une chose, créer une vidéo permanente sur la façon de vous remplacer puis l'attribuer sans redevance ni restriction à quelqu'un d'autre est un jeu d'enfant. Encore une fois: que se passe-t-il si l'employeur se retourne et revend ou autorise cette vidéo?
Tout comme l'employeur se retourne et vend le logiciel que j'ai écrit pendant qu'il me payait? Rien. Si vous souhaitez monter, obsolète votre position actuelle. Si votre employeur actuel n'a nulle part où aller, vous vous êtes rendu plus précieux pour le prochain employeur.
@smci, cela semble être juste des choses opérationnelles spécifiques à l'entreprise - difficilement "vendables". Les projections d'écran sont parfois plus faciles et moins fastidieuses que la prose pour montrer comment on fait quelque chose.
@smci Il existe une énorme charge de screencasts totalement gratuits sur le Web pour effectuer des opérations génériques / informatique / administration / développement / etc. dans toutes sortes de systèmes et d'environnements. La vraie valeur à documenter est les spécificités de l'entreprise que vous ne pouvez pas google. Une telle information ne vaut rien pour quiconque en dehors de l'entreprise (je laisse les hackers / espionnage industriel hors de l'équation).
@Petter: ou il pourrait également s'agir d'une vidéo de 10 minutes contenant des informations hautement exclusives et des secrets commerciaux. Mon argument tient.
@smci, votre argument me semble naïf. Une vidéo est simplement un moyen de transmettre des informations, tout comme la rédaction d'un document ou la réalisation d'une présentation.
@Petter: pas du tout. Je suppose que vous n'avez jamais travaillé que pour des employeurs suédois, qui ont tendance à être assez éthiques. Il y a tout un monde d'autres choses. En général, il n'est pas judicieux de réduire volontairement votre sécurité d'emploi sans contrepartie en retour, mais surtout si vous créez une œuvre et attribuez des droits d'auteur perpétuels, sans aucune restriction sur la façon dont elle peut être réutilisée. D'accord, la plupart des screencasts ne valent pas grand-chose.
mickery
2014-09-18 08:04:23 UTC
view on stackexchange narkive permalink

Les sorties sont souvent un soulagement, mais les derniers mois ou semaines peuvent être émotionnels, voire stressants. Écrire un guide étape par étape n'est pas facile, surtout si l'écriture n'est pas votre façon habituelle de communiquer. Je suppose que vous partez pour une meilleure opportunité et que votre patron actuel a besoin d'un schéma à utiliser lorsque les choses se cassent. Mon conseil est de faire de votre mieux pour éliminer une liste de meilleures pratiques pour résoudre les problèmes courants et ne pas être obsédé par la solution parfaite. Le patron effectuera les ajustements futurs à la volée si nécessaire. Votre obligation est de picorer jusqu'au moment de partir et de rester lucide sur la situation dans son ensemble.

L'Asker semblait penser que le boss n'était pas capable.
@AaronHall: alors le patron fera toujours de futurs ajustements à la volée, mais ils se trompent et ce ne sera pas la faute du questionneur ...
Je ne pense pas que celui-ci méritait les votes négatifs, c'est un conseil assez équilibré.
user8365
2014-09-18 20:15:26 UTC
view on stackexchange narkive permalink

Je peux comprendre votre raisonnement jusqu'à un certain point. Pour moi, l'analogie consiste à remplacer un chef par un cuisinier qui utilise les recettes du chef. La nourriture n'est peut-être pas aussi bonne et cette personne ne pourra probablement pas améliorer le menu et suivre les dernières tendances. Le cuisinier peut ne pas être en mesure de gérer les exceptions comme une nuit très chargée ou être capable de remplacer un ingrédient manquant.

Il prend un risque. Les choses peuvent fonctionner ou non. Cela dépendra en grande partie de la manière dont vous écrivez les instructions. Est-ce juste une liste de faire ceci, puis cela ou allez-vous inclure des captures d'écran et des explications détaillées. Exemple: Si cela se produit, redémarrez le serveur, c'est très bien si la personne le sait et en a l'expérience.

Quelle est la pire chose qui puisse arriver? Ils embauchent finalement quelqu'un qui sait ce qu'ils font?

C'est une assez bonne analogie, mais je pense que ce serait plus comme remplacer un chef par un lave-vaisselle (étant donné que ce serait fait par quelqu'un qui n'est même pas dans le même domaine). Les recettes du chef devraient inclure des choses comme «Comment allumer la table de cuisson» et «Comment hacher les légumes avec un couteau», pas seulement «Cuire ces ingrédients dans cet ordre à cette température». Ils prennent en effet un risque, et je suppose que je me demande aussi si je vais avoir des ennuis si mes instructions ne sont pas assez bonnes pour le lave-vaisselle.
J'ai eu le luxe d'écrire des instructions et de regarder silencieusement par-dessus l'épaule de quelqu'un pendant qu'il l'essayait. Ensuite, j'ai une idée de ce qui doit être corrigé ou ajouté. Si la personne ne comprend tout simplement pas, elle peut être plus persuasive (paniquée) en recommandant d'embaucher quelqu'un qui sait ce qu'elle fait.
@thanby, Comment allumer la cuisinière devrait être dans les recettes, car chaque cuisinière est différente. Hacher les légumes ne devrait pas l'être, à moins que les légumes ne soient hachés d'une manière spéciale.
user27120
2014-09-18 05:18:55 UTC
view on stackexchange narkive permalink

Bien que votre travail consiste à faire ce que votre patron vous dit, il est également de votre devoir d'effectuer vos tâches à la pointe de la technologie. Donc, la rédaction d'un HowTo devrait inclure à qui il est destiné, de quelles qualifications la personne a besoin, où elle a besoin d'une compréhension plus approfondie et pourquoi, et quels risques potentiels viennent avec les tâches si elles ne sont pas effectuées correctement.

Si vous ne le faites pas de manière explicite, vous rencontrez des problèmes juridiques dès que votre remplacement cause des dommages. Théoriquement, vous devriez également conserver une copie des documents que vous créez comme preuve, mais si vous êtes autorisé à le faire, c'est une autre question juridique dont vous devriez discuter avec un avocat. Tout comme la question de savoir si et comment rédiger la documentation doit être discutée avec un avocat.

Un bonus: si vous dites à votre patron que vous avez parlé à votre avocat et que vous l'écrivez exactement comme ceci , il peut difficilement discuter avec cela. ;)

Important: Toutes les discussions que vous avez eues avec votre patron sont inutiles et n'ont jamais eu lieu, écrivez-lui des mails, faites-lui répondre par écrit et gardez des copies.

Dans quel pays quelqu'un peut-il avoir des conséquences juridiques dans un tel cas? Cela semble fou
+1 pour le premier paragraphe. La documentation est essentielle pour les rôles informatiques, mais elle suppose toujours un certain niveau de compétence de la part de la personne qui la lit. Ecrire ce type de documentation technique pour un profane équivaudrait à écrire plusieurs manuels.
Avertissement sur les «problèmes juridiques» == absurdité totale.
Des allégations juridiques non fondées selon lesquelles les «problèmes juridiques» == un non-sens complet sont un non-sens complet. Même si jwg était un avocat en exercice dans la juridiction concernée, il n'a pas votre contrat de travail, au mieux, il indique comment il pense que la propriété intellectuelle devrait fonctionner; ignorez-le.
@msw: "Propriété Intellectuelle" est totalement hors de propos.Il n'y a pas de problèmes juridiques, car le contrat de travail est terminé et le problème hypothétique discuté n'existait pas pendant la période d'emploi.Le texte exact du contrat n'est pas pertinent pour quelque chose qui n'est pas du tout couvert par le contrat.(Et sur une hypothèse, vous blâmeriez simplement votre prédécesseur)
Joe W
2014-09-19 23:14:41 UTC
view on stackexchange narkive permalink

Si vous avez acquis ces connaissances au fil du temps, il est très raisonnable que votre patron vous demande de rédiger un guide sur la façon de le faire afin que les autres n'aient pas à réapprendre ce que vous avez fait. Pensez simplement au temps que cela vous aurait fait gagner si vous aviez écrit certaines de ces instructions lorsque vous avez commencé. Il ne s’agit pas de réduire les coûts en faisant en sorte que quelqu'un soit moins formé pour le faire, mais de ne pas avoir à réapprendre à faire les choses et à refaire les mêmes erreurs.



Ce Q&R a été automatiquement traduit de la langue anglaise.Le contenu original est disponible sur stackexchange, que nous remercions pour la licence cc by-sa 3.0 sous laquelle il est distribué.
Loading...