Das Kommentieren in einer Codeüberprüfung verwaltet
Behandeln Sie Kommentare als Verwaltungsinstrument
Das Einfügen von Kommentaren in eine Codeüberprüfung ist eine Form der Verwaltung. Als solches sollte es als Instrument des Managements betrachtet werden.
Verwenden Sie beim Kommentieren Verwaltungspraktiken
Es gibt eine Struktur für die Verwaltung von Personen, bei der das Ziel darin besteht, ein gewünschtes Ergebnis zu erzielen. Einige der wichtigsten Managementansätze werden nicht in Kommentaren verwendet, die meisten jedoch. Die anwendbaren Themen umfassen Umwelt, Führung, Organisation und Kontrolle.
Umgebung
Kultur
Die Umgebung bestimmt den Führungsstil. Bei der Verwendung von Managementinstrumenten sollten die Kultur und das Umfeld des Arbeitsplatzes berücksichtigt werden. Dies hängt in der Regel von der Branche und der Größe des zu verwaltenden Unternehmens oder der zu verwaltenden Einheit ab.
Stil
Wenn es eine unbeschwerte Kultur gibt, kann dies an der Art des Managements liegen. Wenn es sehr strenge Richtlinien, Richtlinien und Konsequenzen gibt, sollte sich dies im verwendeten Stil widerspiegeln. Wenn also jeder an Bord ist, um einen Star Wars-Witz über Droiden und einen schwachsinnigen Sturmtruppler zu machen, kann eine komödiantische Interjektion angebracht sein. Wenn es jedoch schwerwiegende Konsequenzen gibt, das Endergebnis nicht ernst zu nehmen, muss dies möglicherweise vermieden werden.
Führung
Grundlagen
Es gibt drei Hauptpfeiler der Führung, die bei Kommentaren berücksichtigt werden müssen. Sie sind nämlich Vision, Kommunikation und Urteil.
Vision
Es ist wichtig, dass Sie beim Erklären oder Erteilen von Anweisungen die große Vision im Auge behalten. In Kommentaren könnte dies bedeuten, darauf hinzuweisen, wie sich kleine Änderungen auf das gesamte Projekt auswirken, welche Konsequenzen es hat, wenn unterschiedliche Ansätze verfolgt werden, oder einen wichtigen Hinweis auf die Trennung von Bedenken zu geben.
Communication
In vielen Bereichen des Lebens ist es wichtig, ein guter Kommunikator zu sein. In Kommentaren ist es nicht anders. Es ist wichtig, ein weises Maß an Kürze zu verwenden - zumal Kommentare nicht viel Platz beanspruchen sollten. Gehen Sie frühzeitig auf den Punkt und ergänzen Sie ihn bei Bedarf mit einem Beispiel. In einer größeren Organisation kann dies auch die Notwendigkeit beinhalten, eine Mitteilung oder ein Memo zu versenden, wenn das Problem nicht auf eine Überprüfungssitzung beschränkt ist.
Judgement
Es ist wichtig, dass eine Strategie angewendet wird, um zu beurteilen, ob Kommentare erforderlich sind und welche Änderungen erforderlich sind. Ihr Urteil muss nicht immer richtig sein, aber es muss konsequent richtig sein, insbesondere wenn große Urteilsrufe getätigt werden.
Organisieren
Aus Managementsicht bezieht sich das Organisieren darauf, das Endziel im Auge zu behalten und sicherzustellen, dass die Prozesse so ausgerichtet sind, dass sie einer Reihe von Regeln folgen. Kommentare sollten dies auch berücksichtigen, da die Kommentare nach Möglichkeit aufeinander aufbauen sollten, um sicherzustellen, dass der Designfluss eingehalten wird. Es ist auch wichtig, den Umfang des zu überprüfenden Codes zu berücksichtigen, um die Kopplung zu verringern und das Gesamtdesign zu verfolgen.
Steuern
Die Kontrolle der Aktionen der Verwalteten ist ein heikler Prozess. Wenn man fest ist, sollte man auch bedenken, dass die Menschen wichtig sind. Es gibt verschiedene Managementfähigkeiten, mit denen Sie andere steuern können. Diese Fähigkeiten sind politisch, konzeptionell, zwischenmenschlich, diagnostisch und technisch.
Politisch
Politik ist zu jeder Zeit zu finden, in der Menschen interagieren. Es ist ein großes Thema, aber im Allgemeinen dreht sich die Politik um Einfluss. Es ist wichtig, die persönliche und berufliche Politik bei der Kommentierung im Auge zu behalten. Dies kann mit einer Anweisung, einem Witz oder sogar einer Frage zusammenhängen.
Konzeptionelle
Management durch Konzeptualisierung ist ein wichtiges Instrument. Es erfordert eine komplexe Analyse der vorliegenden Situation. Bei der Kommentierung kann es von Vorteil sein, einen Teil der Analyse einzubeziehen, die verwendet wurde, um die in der Überprüfung angegebene Schlussfolgerung oder Änderung zu erzielen.
Zwischenmenschlich
Zwischenmenschliche Fähigkeiten sind beim Management sehr wichtig. Dies ist auch ein großes Thema. Einige der wichtigen Dinge, die bei zwischenmenschlichen Fähigkeiten berücksichtigt werden müssen, sind Mentoring, konstruktive Kritik und "Harpunieren".
Mentoring
Es ist wichtig, dass das Management eher als Mentor als als Antagonist gesehen wird. In einer Codeüberprüfung bedeutet dies, dass es manchmal von Vorteil ist, auf ein Entwurfsmuster oder einen Entwurfsansatz hinzuweisen, mit dem sich eine Situation verbessern lässt.
Constructive Criticism
Kritik ist wichtig, weil sie zum Nachdenken anregt. Kritik sollte jedoch so positiv wie möglich gehalten werden. Dies bedeutet, gültige Beweise zur Unterstützung der Kritik vorzulegen und sicherzustellen, dass der verwendete Ton nicht negativ ist. Bei der Überprüfung des Codes könnte dies die Anzeige einer Ausnahme oder eines möglichen Szenarios beinhalten, bei dem ein Fehler beim Anzeigen einer Lösung generiert wird, anstatt jede Stelle anzuzeigen, die falsch war, wenn der gesamte Code ohnehin ersetzt werden müsste.
"Harpooning"
"Harpunieren" ist, wenn Sie jemanden im übertragenen Sinne zu Boden harpunieren. Dies geschieht, indem sie Schritt für Schritt ohne Aufschub abgebaut werden, bis sie sich unfähig fühlen, aufzustehen. Wenn Sie eine Person in einer Codeüberprüfung oder anderswo harpunieren, verlieren Sie deren Zusammenarbeit. Es ist wichtig zu vermeiden, dass jemand übermäßig kaputt geht.
Zusammenfassung
Behandeln Sie Kommentare in einer Codeüberprüfung als Verwaltungstool. Beachten Sie, dass Kommentare kurz, sachlich und konstruktiv sein sollten. Stellen Sie außerdem sicher, dass beim Kommentieren die zu überprüfende Person berücksichtigt wird.