Führt die Terminologie ein und vereinheitlicht sie!
Artikel#: 00035
Datum: 2020-10-16
Autor: Radim
Identifiziert, klärt und standardisiert alle Namen und Begriffe bereits zu Beginn des Projekts.
Dies gilt beispielsweise für Maschinenteile und -komponenten, Signale, Prozesse, Funktionen usw.
Tut es, bevor ihr und andere die Namen und Begriffe verwendet.
Tut dies, bevor ihr Debatten führt und Dokumente über das Projekt schreibt.
Vermeidet Mehrdeutigkeiten bei der Benennung und Verwendung mehrerer Begriffe für eine Sache.
Vermeidet es, falsche Begriffe zu verbreiten.
(Weil es schwierig ist, diese falschen Begriffe später zu finden und zu korrigieren.)
Erstellt eine Liste aller Namen mit einer Beschreibung ihrer Bedeutung und einem Bild ihres Auftretens.
Wenn ihr mit Personen in einem internationalen Bereich zusammenarbeitet oder Kunden in mehreren Sprachen beliefert, bittet einen technischen Experten, die Liste in andere Sprachen zu übersetzen.
Ihr könnt eine korrekte Übersetzung vom Kunden erhalten.
Normalerweise kennt er die Fachbegriffe in seiner Sprache am besten.
(Wahrscheinlich besser als eine Dolmetscheragentur.)
Lass die Begriffe und Übersetzungen von mehreren Experten überprüfen.
Verwendet nur die vereinbarten Begriffe in Diskussionen, E-Mails, Protokollen, Dokumentationen, Programmcode und Kommentaren, Schaltplänen, grafischen Benutzeroberflächen, Bedienungsanleitungen usw.
Wenn du dir nicht sicher bist, suche in der Liste nach dem richtigen Begriff.
Wenn du ihn nicht finden kannst, wende dich an den Administrator dieser Liste und gebt einen neuen passenden Begriff in die Liste ein.
Vermeidet nach Möglichkeit die Verwendung von Abkürzungen, da diese möglicherweise nur schwer in eine andere Sprache übersetzt werden können.
Wenn ihr ein Produkt eines Drittanbieters implementiert, verwendet ihr die Terminologie aus desen Dokumentation.
Holt euch auch die Dokumentation zum Produkt des Drittanbieters in den Sprachen, die ihr benötigt, um die Begriffe von dort zu kopieren.
(Zum Beispiel kann ein Text eines Drittanbieters als Alarmtext in der grafischen Benutzeroberfläche implementiert werden.)
© Radim-Automation, 2020–2025. Alle Rechte vorbehalten.
Die Verbreitung dieses Artikels ist mit Angabe der Quelle (Link zur Originalseite) ausdrücklich gestattet.
Verwandte vorherige Artikel:
- Verwirkliche jede gute Idee so schnell wie möglich!
- Bleibe wachsam!
- Hab einen Experten zur Hand!
- Was braucht der Kunde?
- Enttäuscht euren Kunden nicht!
- Stelle Fragen!
- Fordere Bottom-Up-Input auf!
- Konzentriere dich auf das Ziel!
- Schärfe deine Axt, bevor du beginnst zu fällen!
- Verstecke kein Problem!
- Überprüfe das Ergebnis!
- Halte es einfach!
- Gute Kommunikation ist wichtig
- Entwicklung ist Evolution
- Vernachlässige und überspringe keinen Schritt!
- Transparenz und Zuverlässigkeit
- Von einer Idee zu einem konsistenten System
Verwandte nächste Artikel:
- Mach die richtigen Dinge und mach sie richtig!
- Speichere Email-Nachrichten im Projektordner!
- HMI- und SPS-Anwendungen sollen zusammenwachsen
- Schreibe deine Best Practices und Prozesse auf!
- Wer weiss es?
- Schreibe und akzeptiere nur lesbaren Code!
- Verwende einen nützlichen Styleguide!
- Funktionelles und intuitives HMI
- Wer wird operieren?
- Sammelt alle Anforderungen und sortiert sie!
- Projektleiter
- Lerne von deiner Reise!
- Ein gutes Konzept = Kompletter Satz geeigneter Lösungen
- Abkürzungen
- Variablennamen
- Visuelle Modellierung
- Dokumentationsprobleme
- Sprich mit den Bedienern
- SPS-Netzwerkdiagramm
- Halte die Dokumentation während des gesamten Projekts auf dem neuesten Stand
- Pflege Ordnung im Programmkode
- Codeformatierung
- High Performance HMI
- Ein unersetzbarer Mitarbeiter
- HMI - Habt einen konsistenten Stil
- HMI – Übertreibt es nicht mit komplexem Design
- Versteckte Gefahren bei der Inbetriebnahme
- Die falsche Illusion des schnellen Fortschritts
- HMI-Layout-Design
- HMI-Navigation
- Was macht eine HMI intuitiv?
Kommentar#: 00001
Datum: 2020-10-16
Benutzer: Radim
Das Risiko der Verbreitung falscher Begriffe besteht nicht nur in Mehrdeutigkeit und Unverständlichkeit.
Unglaublich witzige schlechte Begriffe können auftreten, insbesondere wenn Wörter buchstäblich von einer Sprache in eine andere übersetzt werden.
Kommentar#: 00002
Datum: 2024-02-22
Benutzer: Radim
Ist Ihre Muttersprache nicht Englisch und arbeiten Sie in einem internationalen Team? Haben Sie sich im Team auf Englisch als Projektsprache geeinigt? Dann bitte:
1. Installieren und benutzen Sie alle Projektwerkzeuge auf Englisch.
2. Verwenden Sie englische Hilfedateien für die Werkzeuge.
3. Schreiben Sie englische Variablennamen und Kommentare in den Code.
Diese Regeln erleichtern die Zusammenarbeit zwischen den Teammitgliedern, die Dokumentation und die Supportaufgaben. Denn die Leute werden die gleichen Begriffe verwenden.
Sind Sie mit diesen Regeln einverstanden?
Würden Sie noch etwas hinzufügen?
Kommentar#: 00003
Datum: 2024-04-10
Benutzer: Radim
"Codekonventionen sind für Programmierer aus mehreren Gründen wichtig:
• 40%-80% der Lebenszeitkosten einer Software entfallen auf die Wartung.
• Kaum eine Software wird während ihrer gesamten Lebensdauer vom ursprünglichen Autor gewartet.
• Codekonventionen verbessern die Lesbarkeit der Software und ermöglichen es den Ingenieuren, neuen Code schneller und gründlicher zu verstehen.
• Wenn Sie Ihren Quellcode als Produkt ausliefern, müssen Sie dafür sorgen, dass er genauso gut verpackt und sauber ist wie jedes andere Produkt, das Sie erstellen."
- https://en.wikipedia.org/wiki/Coding_conventions
(übersetzt aus dem Englischen)