Wäre Ihre Firma in Schwierigkeiten, wenn Sie von einem Bus angefahren würden?

27

Bei der Arbeit bin ich der einzige IT-Mann (mache alles und schreibe jetzt) ​​seit 10 Jahren. Wenn ich jemals von einem Bus angefahren würde, wären sie total durcheinander. Ich habe es mehrmals vor Führungskräften / Präsidenten erwähnt, aber sie ignorieren mich. Schade für sie.

Was kann ich tun, um ihre Schmerzen zu lindern? (Oder sollte es mich überhaupt interessieren?)

(Ja, dies sollte ein Community-Wiki sein, aber ich sehe das Kontrollkästchen nicht ... vielleicht habe ich nicht genug Repräsentanten.)

MDMarra
quelle
1
Ich stimme nicht zu, es würde niemanden interessieren, ob du stirbst. Wenn das Unternehmen nur wegen dir im Geschäft ist, dann bist du nicht nur ein IT-Mann.
10.

Antworten:

50

Dokumentieren Sie den Teufel aus allem heraus.

Vor kurzem gab es auf Slashdot einen Thread zum Starten der Dokumentation, der mich dazu inspirierte, meine Gedanken zur Dokumentation niederzuschreiben.

Meine wichtigsten Punkte waren:

Prinzip Nr. 1: Es wird niemals getan

Die Dokumentation ist ein ständiger Aufwand, der immer hinter dem zurückbleibt, was in der Produktion ist. Änderungen werden ad-hoc vorgenommen, Dinge verschoben oder eingestellt oder nach dem Zufallsprinzip in Betrieb genommen. Dokumentation wird nie aufholen.

Sie müssen den Rechnungszahlern den Wert der Zeit (und damit des Geldes) für die Aktualisierung der laufenden Dokumentation verkaufen. Häufig lauten diese Unterhaltungen wie folgt: "Erinnerst du dich, als ich $ TIME damit verbringen musste, herauszufinden, wie $ THING kaputt war? Nun, als ich fertig war, gab es diese technische Notiz, in der $ THING genau beschrieben wurde, damit der nächste Kerl nicht mitkommt Ich muss alles herausfinden. "

Sie müssen es tun, obwohl Sie nie fertig werden.

Prinzip 2: Die einzige Sache, die schlimmer ist als keine Dokumentation, ist die falsche Dokumentation

Dies ist eher eine Binsenweisheit als ein Prinzip. Die Dokumentation kann Sie in den falschen Sinn wiegen, dass sich etwas in einem bekannten Zustand befindet, und dass Sie, wenn etwas schief geht, sofort damit beginnen können, es zu beheben.

Es ist wichtig, dieses Problem anzuerkennen.

Prinzip 3: Sie schreiben eine Dokumentation für Ihren Nachfolger

Die Wahrscheinlichkeit ist 95% von allem, was Sie dokumentieren, worauf Sie sich nie wieder beziehen müssen. Dokumentation ist eine Sammlung von Weisheiten für die Zukunft, nicht für Sie. Sie müssen also davon ausgehen, dass Ihr Publikum nur wenig oder gar nichts über die Besonderheiten weiß, wie die Dinge so sind, wie sie sind.

Und es wird einen Nachfolger geben. Ich weiß nichts über dich, aber ich habe nicht vor, für den Rest meines Lebens in diesen speziellen Umgebungen zu sein. Gelegenheiten kommen und gehen, und wenn sie kommen, gehst du manchmal. Aber das Leben geht hinter dir weiter, und je ruhiger du für deinen Nachfolger leben kannst, desto besser. Andernfalls könnten Sie eine Ansammlung ehemaliger Kunden haben, die leise schmeichelhafte Dinge über Sie sagen. Ich möchte sagen, dass es die gleichen 50 Leute sind, die überall in der IT in Ottawa arbeiten, weil man ihnen überall begegnet. Wenn Sie Ihrem Nachfolger helfen, können Sie in Zukunft möglicherweise Türen öffnen.

Bis zu einem gewissen Grad gibt es immer ein gewisses Maß an "Schuld dem Vorgänger", wenn Probleme auftauchen. Das gehört zum Geschäft. Ich habe es selbst gemacht. Aber bei mehreren Gelegenheiten, als ich den vorherigen Typen als eine Art Idioten verprügelt hatte, habe ich ansonsten erfahren, dass er wirklich seine Tat zusammen hatte und mehr über das wusste, was los war, als ich es damals tat.

Prinzip 4: "Warum" ist oft wichtiger als "Wie"

Wenn die meisten von uns ein System betrachten, denken sie, warum zum Teufel ist das so? Es gibt fast immer sehr spezifische Gründe für die getroffenen Konfigurationsentscheidungen. Unter diesen Umständen gibt das "Warum" das "Wie" vor und Sie müssen sicherstellen, dass der Leser die spezifischen Probleme versteht, die bei der Untersuchung der Rauchreste Ihrer Lösung gelöst werden.

Prinzip # 5: Es muss einfach sein oder du wirst es nicht tun

Dies bedeutet, dass Sie sich Ihrer Werkzeuge sowie derer, die Ihre Werkzeuge verwenden, sehr bewusst sein müssen.

Es muss einfach sein, die Dinge auf dem neuesten Stand zu halten. Wenn Sie sich anstrengen müssen, werden Sie Ausreden finden, um dies zu vermeiden, wenn es am besten ist, was unmittelbar nach einer Änderung der Fall ist.

Wenn Ihre Werkzeuge für andere nicht einfach zu verwenden sind, werden sie sie nicht verwenden. Dies kann in einer Teamumgebung besonders lähmend sein, da je größer das Team ist, desto wahrscheinlicher ist es, dass Sie auf ein Teammitglied treffen, das Ihre Werkzeugauswahl nicht mag.

Persönlich mag ich ein Wiki für Dokumente. Das Problem ist jedoch, dass ein Wiki Ihnen keine Struktur aufzwingt, sodass die Struktur von außen auferlegt werden muss. Dies führt immer irgendwo zu Konflikten, da jemand anderes eine bessere / andere Idee hat.

An einigen Stellen habe ich Word- und Visio-Dokumente verwendet, die als PDF "veröffentlicht" wurden, wobei das "neueste" PDF als maßgeblich gilt. Dies ist insofern gut, als Sie dann eine Sammlung haben, die Sie Ihrem Arbeitgeber / Nachfolger übergeben können. Wenn die PDF-Dateien korrekt datiert sind, können sie eine historische Aufzeichnung dessen enthalten, was passiert ist, obwohl eine solche Aufzeichnung nicht einfach zu durchsuchen ist. Es ist schlimm, dass ich Word oder Visio nicht mag und gezwungen bin, ein grundlegendes Verständnis dieser Tools zu erlangen, um die Ideen effektiv zu kommunizieren.

Mein jetziger Arbeitgeber spielt mit der Idee von Word-Dokumenten in einem Sharepoint-Portal. Wir müssen nur sehen, wie weit wir dort sind

David Mackintosh
quelle
Gute Antwort. +1 wenn ich könnte.
@roygbiv - Warum kannst du nicht? Du hast genug Wiederholungen (> 15)
Rook
@Idigas - Zu dem Zeitpunkt, als ich den Kommentar abgegeben habe, hatte ich nicht genug Repräsentanten. :)
Konnte dieser Antwort nicht mehr zustimmen. Ich verwende gerne Word-Dokumente mit einem einheitlichen Stil (einige Dinge wachsen in ihr eigenes Handbuch hinein). Einige Menschen sind besorgt über den Verlust der Arbeitsplatzsicherheit, aber es reicht nicht immer aus, über Unterlagen zu verfügen. Ich muss Kenntnisse und Fähigkeiten mitbringen, wie einer meiner früheren Arbeitgeber herausfand, nachdem sie mich verkleinert hatten und mein Nachfolger nicht genug über IT wusste (er war in erster Linie ein Programmierer).
Scott
Ich bin damit einverstanden, dass ich mit jedem Job, den ich jetzt annehme, die Hölle rausschmeiße, nicht nur für das Unternehmen, sondern auch für mich. Manchmal macht man etwas, das man nur gelegentlich macht, und wenn man das nicht so oft macht, vergisst man es und muss herausfinden, wie man es wieder macht. Ich finde es toll, dass ich einfach in meinen Ordner gehe, wo ich das aufbewahre, meine Dokumente erneut lese und mich daran erinnere, wie es geht.
Hondalex
8

Natürlich solltest du dich darum kümmern. Jeder Job, der es wert ist, getan zu werden, ist es wert, gut getan zu werden.

1.) Es wurde bereits gesagt, aber es muss zur Wiederholung wiederholt werden. Dokument, Dokument, Dokument. Verwenden Sie Excel-Tabellen, Briefpapier, Federkiel und Pergament, wenn Sie müssen. Notfalls mehrere tausend Methefte wie im Film "Se7en". Legen Sie es so oder so klar, präzise und leicht lesbar dar, für wen auch immer Sie ersetzt werden müssen, wenn Sie von einem Meteor getroffen werden.

2.) Sobald Sie alles dokumentiert haben, sollten Sie in der Schreibstimmung sein. Es ist Zeit, ein Nebenprojekt zu starten, in dem die auf den Servern vorgenommenen Änderungen der letzten Jahre aufgeführt sind. Beginnen Sie mit dem Aufbau eines Change-Management-Prozesses, aber gehen Sie ihn historisch durch. Stellen Sie sicher, dass Sie notieren, wie oft Sie diese Datenträger auf einigen dieser heiklen Server geändert haben. Wie viel sie kosten usw. Sie können sich auf diese Daten verlassen, auch wenn dieser Meteor Sie vermisst und stattdessen den Hund des Nachbarn aus dem Weg räumt.

3.) Implementieren Sie ein Überwachungssystem, das kritische Fehler überwacht und per E-Mail versendet. Was ist das, sagst du? Hast du schon einen? Süss! Jetzt dokumentiere es. Wie es funktioniert, was Sie überwachen, warum Sie es überwachen.

4.) Sie haben die Verantwortung, es wieder Ihren Managementtypen zu überlassen. Und immer wieder. So oft du kannst. Höflich sein. Seien Sie respektvoll, aber tragen Sie die Kosten für das Geschäft, wenn dieser Meteor herunterfällt und Sie verschwinden.

Dies ist keine Verantwortung, die Sie aufgeben können, sondern eine ethische Anforderung an Ihre Arbeit, die Sie als sprichwörtlicher "Bewahrer und Hüter der Schlüssel zum Königreich" bekennen.

Denk darüber so. Wenn Sie vermeiden und vergessen können, sich darüber Sorgen zu machen, und sich dabei in Ordnung fühlen, warum kämmen Sie dann nicht die Buchhaltungs-Fileshares für Unternehmensgehälter, um zu sehen, was und wie viel mehr diese Managementtypen als Sie verdienen. Warum nutzen Sie vertrauliche Unternehmensdaten nicht für Ihren eigenen Gebrauch? Warum liest du keine E-Mails?

Einfach ausgedrückt (und hoffentlich) tun Sie diese Dinge nicht, weil Sie ein solides Gespür für Moral und Ethik haben. Weißt du, das Ganze ist richtig oder falsch. Wenn Sie das haben, wissen Sie, dass es eindeutig Ihre Verantwortung ist, Gegenmaßnahmen gegen den schlimmsten Fall zu dokumentieren und vorzubereiten.

Dies ist Ihre arbeitsfreie und erholsame Urlaubsreise nach Hawaii. :)

(Also ohne Meteor.)

Greg Meehan
quelle
6

Überqueren Sie vorsichtig die Straße, schauen Sie in beide Richtungen und stellen Sie sicher, dass keine Busse mit Keanu Reeves und Sandra Bullock die Straße entlang fahren.

ChrisHDog
quelle
3

Wenn Sie die Lernkurve für Ihren Ersatz verringern möchten, können Sie am besten eine Dokumentation des Aufbaus und Ihrer Prozesse erstellen. Möglicherweise ist der einfachste Weg, dies zu tun, irgendwo ein Wiki-System einzurichten und es einfach weiter zu ergänzen. Einiges davon wird veraltet sein, aber was nicht ist, wird von unschätzbarem Wert sein.

David Pashley
quelle
3

Die vielen oben genannten Beiträge zur Wichtigkeit der Dokumentation sind genau richtig, aber es gibt noch einen weiteren Aspekt, wenn man "der Typ" bei der Arbeit ist, nach dem man Ausschau halten möchte.

Wenn Sie die einzige Person sind, die alles beherrscht, sind Urlaube / Geburten / Notfälle schwer zu bewältigen, und Sie können niemals befördert werden oder andere Positionen im Unternehmen erlernen (wenn dies Sie interessiert). Wenn Sie nicht in der Lage sind, zu wachsen, zu lernen und Ihre Fähigkeiten zu erweitern, könnten Sie in einer Position landen, in der Sie nach einem Job suchen, und Ihr Lebenslauf zeigt, dass Sie 10 Jahre als COBOL / FORTRAN-Programmierer oder Programmierer verbracht haben OS \ 2 / Novell / NT-Administrator.

Wachstum und Überanstrengung sind für die Entwicklung als Systemadministrator wichtig. Anstatt "der Typ" zu sein, von dem das gesamte Netzwerk abhängt, sei "der Typ", der immer bereit ist, dem Neuen zu zeigen, was zu tun ist und der immer daran interessiert ist, mehr über das Geschäft zu erfahren.

Sean Earp
quelle
Hey Sean, stimme vollkommen zu. Nur weil ich 10 Jahre an einem Ort war, heißt das noch lange nicht, dass ich hinter der Zeit bin. Im Gegenteil, ich halte mich auf dem
1

Der Schlüssel hier ist eine detaillierte und vollständige Dokumentation. Dies ist nicht nur für den Fall kritisch, dass Sie arbeitsunfähig sind, sondern auch, wenn eine jüngere Person hereinkommt und Sie in den Urlaub fahren möchten (oder auf grünere Weiden gehen möchten). Wenn Sie über die richtigen Dokumente und Referenzen verfügen, kann dies für andere sehr hilfreich sein, um sich über das Netzwerk zu informieren.

David Yu
quelle
1

Ich versuche SEHR SCHWER, um sicherzustellen, dass wir keine SPoF-Kenntnisse haben, einschließlich meiner eigenen. Diese Einstellung ist wertvoller als jedes lokale Wissen, das ich für mich behalten hätte.

Chopper3
quelle
1

Ich habe diese Position (Sys Admin / Lead Dev) von einem Typen übernommen, der seine eigene Art hatte, alles zu machen. Die 17 Server, die wir haben, sind alle leicht unterschiedlich eingerichtet. Es gibt hier so viele Verfahren und manuelle Bearbeitung von Problemen, und kaum eines davon wurde dokumentiert (die Dokumentation enthielt so gut wie eine einzeilige Erklärung jedes Servers und seiner Rolle). Dies hat mich veranlasst, viele Prozesse im Büro neu zu bewerten. Jedes Mal, wenn ich etwas lerne, wird es dem Wiki hinzugefügt. Ich delegiere auch einige Serverarbeiten an andere Entwickler, damit diese zumindest minimale Informationen über kleine Jobs erhalten.

Dokumentationsschreiben ist zum Kotzen, aber überlegen Sie, wie es wäre, ohne irgendetwas in Ihre Position zu kommen.

Christian
quelle
1

Dokumentation ist eine große Sache. Wo ich gerade bin, habe ich genau das gegenteilige Problem wie Sie. Wir haben kürzlich ein neues POS / Order Tracking-System eingeführt (wir sind eine Gravur- und Werbeagentur) und ich habe das Problem, Leute dazu zu bringen, in das zu schreiben System die Informationen über die Anpassung. Hauptsächlich Leute auf niedriger Ebene, da der Manager dies für ihre Bestellungen tut, weil sie es für alle Bestellungen getan hat und es in eine SEHR ALTE Zugangsdatenbank gestellt hat. Ich so will papierlos gehen, und es ist durchaus möglich , in unserem Geschäft, aber ich kann einfach nicht bekommen die Menschen die Arbeit , um Informationen in, verdammt noch mal eingeben.

Also, steckt weiter bei der Autorisierung weg. Oder wenn Sie sich gut fühlen, tun Sie es in Ihrer eigenen Zeit. Es könnte eine gute Sache für Ihre Zukunft im Unternehmen sein, ganz zu schweigen von Ihrem Nachfolger.

Cameron Conner
quelle
1
Vergewissern Sie sich daher mit Unterstützung des Managers, dass die Anpassungen nachverfolgt werden. Suchen Sie dann einige Zeit später die Person, die sie vorgenommen hat, und dokumentieren Sie sie, wenn sie vergessen haben, was sie getan haben. Das treibt in der Regel den Grund für die ordnungsgemäße Dokumentation nach Hause.
gbjbaanb
Das Problem ist, dass ich sie noch nicht dazu bringen muss, die Papierdokumentation wegzuwerfen, damit Ihre Idee nicht funktioniert. Ich versuche, auf einfache Weise die signierten Proofs und dergleichen einzuscannen und automatisch in einem Ordner zu speichern. Der Benutzer muss nur die Auftragsnummer eingeben, die dann der Dateiname ist. Ich habe noch keinen Weg gefunden, um dies unter OS X zu erreichen.
Cameron Conner
1

re: soll es mich interessieren

Wenn Ihr Büro nicht zu 100% gestört ist, werden die Leute bemerken, dass Sie dafür sorgen, dass die Dinge reibungsloser funktionieren. Dass Ihnen das Wohlergehen des Unternehmens am Herzen liegt und Sie nicht nur an Ihrer „Unentbehrlichkeit“ festhalten. Das Unternehmen, das darauf setzt, dass Sie niemals ein besseres Angebot abgeben oder erhalten, funktioniert nicht sehr gut. Es ist jemandes JOB, zu bemerken, dass Sie so etwas der Firma vorenthalten.

Ich persönlich LIEBE es, mit Menschen zu arbeiten, die dokumentieren und wollen, dass die Arbeit, die sie beendet haben, für sich steht und nicht ständig ihre Beteiligung erfordert. Wenn Sie die bereits erledigten Arbeiten dokumentieren und hinter sich lassen, haben Sie mehr Zeit, um an zukünftigen Projekten zu arbeiten.

Kara Marfia
quelle
0

Wir haben im Grunde die gleiche Situation. Aus diesem Grund hat mich der Regisseur beauftragt, einen weiteren Wissensknoten hinzuzufügen.

Aber ehrlich gesagt, ist es nicht Ihr Platz, um sich zu sorgen. Es ist Aufgabe des Managements, Risiken einzuschätzen und anzugehen.

Mastermind
quelle
Einverstanden. Es ist wichtig, das Management auf die Probleme aufmerksam zu machen, die auftreten können, wenn der einzige IT-Mitarbeiter nicht verfügbar ist. Es ist jedoch nicht Ihre Aufgabe, sie zu nerven, bis sie das tun, was Sie wollen. Es ist wahrscheinlich eine gute Möglichkeit, sich selbst in heißes Wasser zu stürzen.
gillonba
-1 für "es ist nicht dein Platz, um sich zu sorgen". Es ist schwer, dieses Urteil zu fällen, ohne das Organigramm in der Firma des OP zu sehen.
Ben Dunlap
Und die Tatsache, dass er sich darum kümmert, bedeutet , dass er um die Gesundheit und den Erfolg seines Unternehmens besorgt ist. Was gut ist.
Ben Dunlap
@rotard Das OP muss nicht langweilig sein - das Aufschreiben einiger "Wesensmerkmale" und das Speichern von zwei Kopien an sicheren Orten außerhalb und vor Ort sowie die Benachrichtigung seines Managements werden das Problem lösen, ohne zu langweilig zu werden.
Ben Dunlap
0

Ich habe festgestellt, dass der Ansatz „ Getting Things Done“ dabei hilft, die anfängliche mentale Barriere zu überwinden, die Sie daran hindert, Ihre Arbeit ordnungsgemäß zu dokumentieren. Stellen Sie sich Dokumentation nicht als monolithische Aufgabe vor, die Sie daran hindert, "echte" Arbeit zu leisten, sondern unterteilen Sie sie in mundgerechte Abschnitte. Notieren Sie sich alle Informationen, die Ihr Nachfolger wissen sollte. Dann reservieren Sie ein oder zwei Stunden pro Woche, um Ihr Wissen zu überprüfen, zu klären und zu kategorisieren.

Hirvox
quelle
-1
  • Dokumentation: Wichtig
  • Ihre wertvolle Arbeit: Nicht so wichtig, wie Sie denken
Spoulson
quelle
Vielleicht bin ich nur kurz über das Thema, aber ich würde mich über Feedback mit einer Gegenstimme freuen.
Spoulson
Ich habe die Antwort nicht abgelehnt, da es nicht so schlimm ist. Sie haben vielleicht das Gefühl, dass es nicht hilfreich war. Keine Beispiele oder Erläuterungen haben es möglicherweise veranlasst. Ich denke mal wieder, wie du.
Matt
raten nicht raten. Entschuldigung :)
Matt
Sicher. Ich hatte nicht vor, ein Buch zu schreiben, aber wenn ich es täte, würde es "Don't Be Pretentious" heißen.
Spoulson
-4

Nicht dokumentieren. Teile dein Wissen nicht mit anderen. Indem Sie Dinge dokumentieren, verlieren Sie an Wert. Sie werden weniger bezahlt. Ihr Bonus wird geringer sein. Ihre Arbeitsplatzsicherheit wird verringert. Wieso würdest du das machen?

Das richtige Gleichgewicht ist, wenn Sie im Schlaf oder im Urlaub nicht unnötig gestört werden. Ansonsten entwerten Sie sich.

carlito
quelle
Das ist wirklich ein guter Punkt, aber ich denke, er erwartet, dass das Unternehmen nach ein paar Jahren die IT-Abteilung aufbauen wird und er der Chef davon sein kann (jetzt ist er der einzige IT-Mann). Wenn er stirbt, wird die Gesellschaft in Ordnung sein, weil sie einen Kerl wie ihn finden werden.
10.
Je nach Unternehmen ist dies entweder kurzsichtig oder überlebensnotwendig. Ich vermute, dass es häufiger der erstere ist.
Kara Marfia
1
Dies ist wahrscheinlich der egoistischste Rat, den ich je gelesen habe.
Spoulson
Sie würden sich dafür entscheiden, Ihrem Management nicht zu gehorchen, ein wesentlich geringeres Gehalt für sich selbst zu erhalten, als weniger wertvoll und fleißig wahrgenommen zu werden. Langfristig erhalten Sie ausreichend weniger Einkommen und haben eine schlechtere Arbeitsplatzsicherheit, so dass Sie die Zukunft Ihrer Familie beeinflussen. Alles nur, weil Sie ein Unternehmen dazu zwingen wollen, das zu tun, was für sich selbst richtig ist, obwohl es keine ähnliche Liebe für Sie hat. Ich denke, Sie verwirren, wie sehr das Unternehmen Sie respektiert und liebt, wenn Sie bereit sind, so große Opfer zu bringen, um ihnen etwas zu geben, von dem sie glauben, dass sie es nicht wollen.
carlito
2
Notiz an mich selbst. Wenn Sie Sys Admins einstellen, fragen Sie, ob sie einen Benutzernamen für serverfault haben. Wenn sie sie fragen, ob sie Chuck sind, stellen Sie ihn nicht ein.
Matt