Moin zusammen.
Wie kommentiert Ihr eure Anlagen?
Gibt es gute sinvolle Abkürzugen?
Ich habe bisher fast alles im klartext beschriftet. Dadurch bin ich aber schon in diversen Modulen am Ende, obwohl nur die Hälfte der Funktionen genutzt werden. Ich kann mich auch nur schlecht festlegen wie weit in die Tiefe ich überhaupt kommentieren sollte.
Könnte Ihr mal ein repräsentatives Beispiel hier einstellen? Mir geht es nicht um die eigentliche Funktion sondern nur um die Kommentare.
Ich bin gespannt auf Antworten. Danke schon mal.
Siebo
Willkommen auf unserer neuen Forenplattform für das Bus-Profi Forum
Neue Felder für die persönlichen Daten
Man kann jetzt seine öffentlich einsehbare Daten genau bestimmen. Details findet ihr in in diesem Beitrag.
Durch die neue Forensoftware und die Portierung der Daten konnten die Passwörter aus dem alten Forum nicht übernommen werden, bitte lassen Sie sich ein neues Passwort über die Passwort vergessen Funktion zusenden. Sollte es zu Problemen kommen kontaktieren Sie das Bus-Profi Team per E-Mail.
Neue Felder für die persönlichen Daten
Man kann jetzt seine öffentlich einsehbare Daten genau bestimmen. Details findet ihr in in diesem Beitrag.
Durch die neue Forensoftware und die Portierung der Daten konnten die Passwörter aus dem alten Forum nicht übernommen werden, bitte lassen Sie sich ein neues Passwort über die Passwort vergessen Funktion zusenden. Sollte es zu Problemen kommen kontaktieren Sie das Bus-Profi Team per E-Mail.
Kommentare in der Programierung
#2 RE: Kommentare in der Programierung
Moin Siebo,
natürlich gibt es sinnvolle Kürzel - schau dir doch nur mal die Modulbezeichnungen vom LCN an
Nein, ernsthaft. Die von mir verwendeten Kürzel habe ich auch schon bei anderen Kollegen gefunden.
Ein 'STV BMI WZ.D1' sollte so klar sein, auch eine Tasterbezeichnung vom T8 kommt mit o.re oder u.lks.o immer deutlich genug rüber (die Funktion kann ich dann meist über den programmierten Aktor nachvollziehen).
LG, Uwe
natürlich gibt es sinnvolle Kürzel - schau dir doch nur mal die Modulbezeichnungen vom LCN an
Nein, ernsthaft. Die von mir verwendeten Kürzel habe ich auch schon bei anderen Kollegen gefunden.
Ein 'STV BMI WZ.D1' sollte so klar sein, auch eine Tasterbezeichnung vom T8 kommt mit o.re oder u.lks.o immer deutlich genug rüber (die Funktion kann ich dann meist über den programmierten Aktor nachvollziehen).
LG, Uwe
----------------o00o----'(_)'----o00o---------------------
-
Thomas.Einzel
- Lord Forum
- Beiträge: 1178
- Registriert: Do 30. Mai 2002, 07:59
- Status: Offline
#3 RE: Kommentare in der Programierung
Viel Platz sparen kann man mit CamelCase in Abkürzungen. Statt Ta.Wohnz.Tür-links ->TaWzTürLin oder TaWzTürLi oder da es ohnehin bei einem Taster steht: WzTürL nur 1/3 des ursprünglichen Platzes (5 statt 18)obeis hat geschrieben:Moin zusammen.
Wie kommentiert Ihr eure Anlagen?
Gibt es gute sinvolle Abkürzugen?
Ich habe bisher fast alles im klartext beschriftet. Dadurch bin ich aber schon in diversen Modulen am Ende, obwohl nur die Hälfte der Funktionen genutzt werden. Ich kann mich auch nur schlecht festlegen wie weit in die Tiefe ich überhaupt kommentieren sollte.
Könnte Ihr mal ein repräsentatives Beispiel hier einstellen? Mir geht es nicht um die eigentliche Funktion sondern nur um die Kommentare.
Ich bin gespannt auf Antworten. Danke schon mal.
Siebo
Wenn man generell kein Wort "Licht" verwendet, sondern z.B La(mpe) reicht auch Li für links und La für Lampe, auch L und R geht, wenn man das durchgängig macht, L ist links und La ist Lampe z.B. Das alles mit der Häufigkeit bringt schon ein bisschen. Ich empfehle dir eine Art generelles Abkürzungsverzeichnis, "immer gleich" prägt ein. Wer statt Roll oder Ro immer Rollladen (o.ä.) schreibt, ist mit dem Kommentarplatz schnell am Ende.
Thomas
#4 RE: Kommentare in der Programierung
Also wenn man aber zu viel Abkürzt dann weis ein anderer wieder nicht was man damit gemeint hat!
Grüße aus Baden an den rest der Welt.
-
Thomas.Einzel
- Lord Forum
- Beiträge: 1178
- Registriert: Do 30. Mai 2002, 07:59
- Status: Offline
#6 RE: Kommentare in der Programierung
Hm, also ist es besser den Kommentar mangels Platz nach der Hälfte der Funktionen wegen "Platz zu Ende" gar nicht zu haben?Also wenn man aber zu viel Abkürzt dann weis ein anderer wieder nicht was man damit gemeint hat!
Finde ich etwas komisch.
P.S. Wenn man ein durchgängiges Abkürzungsverzeichnis hat, kann man das zum Verständnis für andere auf die Innenseite der UV Tür mit dem PK(U) kleben.
Thomas
#7 RE: Kommentare in der Programierung
So mal eine kleine Anlage zum schauen wie ich es so mache!
- Dateianhänge
-
[Die Dateierweiterung lp3 wurde deaktiviert und kann nicht länger angezeigt werden.]
Grüße aus Baden an den rest der Welt.
#8 RE: Kommentare in der Programierung
Moin Moin
Danke für das Beispiel. Aber das maht mir gerade etwas Angst. bei 300Moduen habe ich nicht mehr weiter gerechnet. Was bitte ist dann eine große Anlage?
Ich fand meine 20 Module schon nicht schlecht.
Wie groß sind den hier die größten betreuten Anlagen der BusProfi Mitglieder? Ich will ja nicht neugierig sein aber das interesiert mich schon.
Siebo
Siebo
Danke für das Beispiel. Aber das maht mir gerade etwas Angst. bei 300Moduen habe ich nicht mehr weiter gerechnet. Was bitte ist dann eine große Anlage?
Ich fand meine 20 Module schon nicht schlecht.
Wie groß sind den hier die größten betreuten Anlagen der BusProfi Mitglieder? Ich will ja nicht neugierig sein aber das interesiert mich schon.
Siebo
Siebo
#9 RE: Kommentare in der Programierung
Ja es sind nicht alle Standorte miteinander Verknüpft bisher wo noch kommen soll!
Die fehlen bei der Datei ja noch!
Die fehlen bei der Datei ja noch!
Grüße aus Baden an den rest der Welt.
-
Beleuchtfix
- Administrator
- Beiträge: 5304
- Registriert: Mi 10. Jan 2007, 18:49
- Kontaktdaten:
- Status: Offline
#10 RE: Kommentare in der Programierung
@Thomas,
irgendwo muss man immer Kompromisse eingehen. Eine Grundbeschriftung ist immer möglich. Je mehr wir in die Module quetschen, desto unübersichtlicher wird natürlich auch alles. Sinnvolle Abkürzungen ohne AKüFi (Abkürzungsfimmel) muss man dann schon verwenden. Hier ist jeder erst mal für seine eigen Installation verantwortlich.
Wenn die Abkürzungen durchgängig sind (das muss man dann schon etwas vorher planen, die CamelCase Methode spricht mich sehr an, kommt man schon sehr weit. Außerdem kannst du ja auch eine Abkürungsliste mit zur normalen Elektro-Dokumentation heften.
Wenn du trickreich (über Module hinweg, Tasten verdoppeln oder Logik auslagern, weil bei Modul xxx noch die Taste C7 kurz frei ist) programmierst, wie wir Häuslebauer das aus Spargründen gerne machen, dann solltest du das richtig gut (auch extern) dokumentieren, denn sonst kämpfst du dich bei jeder kleinen Änderung wieder durch deine Gedanken von vor x Jahren.
Viel Spaß beim Erdenken sinnvoller Abkürzungen
Florian
irgendwo muss man immer Kompromisse eingehen. Eine Grundbeschriftung ist immer möglich. Je mehr wir in die Module quetschen, desto unübersichtlicher wird natürlich auch alles. Sinnvolle Abkürzungen ohne AKüFi (Abkürzungsfimmel) muss man dann schon verwenden. Hier ist jeder erst mal für seine eigen Installation verantwortlich.
Wenn die Abkürzungen durchgängig sind (das muss man dann schon etwas vorher planen, die CamelCase Methode spricht mich sehr an, kommt man schon sehr weit. Außerdem kannst du ja auch eine Abkürungsliste mit zur normalen Elektro-Dokumentation heften.
Wenn du trickreich (über Module hinweg, Tasten verdoppeln oder Logik auslagern, weil bei Modul xxx noch die Taste C7 kurz frei ist) programmierst, wie wir Häuslebauer das aus Spargründen gerne machen, dann solltest du das richtig gut (auch extern) dokumentieren, denn sonst kämpfst du dich bei jeder kleinen Änderung wieder durch deine Gedanken von vor x Jahren.
Viel Spaß beim Erdenken sinnvoller Abkürzungen
Florian
Offizieller KNX Partner 