FHEM Forum

FHEM - Entwicklung => Wunschliste => Thema gestartet von: czcbe am 03 Januar 2019, 09:17:32

Titel: [gelöst] Changelog gewünscht mit mehr Infos
Beitrag von: czcbe am 03 Januar 2019, 09:17:32
Hallo zusammen

Immer wieder erhalte ich über den Befehl "update check" Informationenen, welche Updates anstehen. Häufig muss ich feststellen, dass nur wenige Updates konkrete Angaben dazu machen, was geändert wird. (und ich meine nicht im Detail auf Codeebene, sondern eher vereinfachte/funktionelle Erläuterungen)
Dabei könnte ich dann natürlich viel besser beurteilen, was für Auswirkungen auf mein System zu "befürchten" sind. Wenn das fehlt tappe ich im Dunkeln.

Könnte man da nicht nachbessern und mehr Infos veröffentlichen?

Hier ein Beispiel:

Zitatfhem
List of new / modified files since last update:
UPD ./CHANGED
UPD FHEM/31_Aurora.pm
UPD FHEM/37_harmony.pm
UPD FHEM/49_SSCam.pm
UPD FHEM/73_AutoShuttersControl.pm
UPD FHEM/lib/AttrTemplate/mqtt2.template

New entries in the CHANGED file:
  - bugfix:  73_AutoShuttersControl: fix typo in commandref
  - change:  49_SSCam: V8.3.1, change usage of older SMTP versions when Email
                       shipping is used
  - feature: 73_AutoShuttersControl: add support blockingAfterManual at
             Brightness, Bugfixes

Es fehlen Infos über Harmony (da gab es ja etliche Diskussionen und Spekulationen/Änderungen dazu in den letzten Tagen, daher würde ich schon gerne wissen, was sich ändern wird oder neu ist).
Titel: Antw:Changelog gewünscht mit mehr Infos
Beitrag von: Beta-User am 03 Januar 2019, 09:39:27
@czcbe
Zur Info:
Was jeweils in Changed angezeigt wird (bzw. als Infotext auch bei den einzelnen Dateien im svn), liegt allein in der Verantwortung desjenigen, der die Änderungen eincheckt.

Da die gewünschte Funktionalität eigentlich vorhanden ist, gehört das eigentlich nicht auf die allgemeine Wunschliste, sondern wäre jeweils mit dem einzelnen Verantwortlichen zu klären...
Titel: Antw:Changelog gewünscht mit mehr Infos
Beitrag von: PatrickR am 03 Januar 2019, 13:09:04
Mahlzeit!

Ich finde den Vorschlag explizit gut.  In der Vergangenheit gab es an der ein oder anderen Stelle Patches, die bestehende Definitionen in einen defekten Zustand überführt haben. Teilweise war das Problem nicht einmal erkennbar, da das Gerät nach wie vor vorhanden war. Das halte ich für erwähnenswert im Changelog, das Forum reicht hier m. E. nicht.

Ich bin mir natürlich bewusst, dass Developer in FHEM große Freiheiten genießen, was sicherlich einen deutlichen Einfluss auf die Motivation der Entwickler hat. Bemerkenswert finde ich, dass die Zahl der Probleme nach meiner Wahrnehmung verschwindend gering ist. Ich glaube, wenn man sich auf die o. g. Breaking Changes als Minimum für das Changelog einigen könnte und gleichzeitig das Changelog generell etwas mehr im Hinterkopf hält, wäre das ein guter Anfang.

Patrick
Titel: Antw:Changelog gewünscht mit mehr Infos
Beitrag von: vbs am 03 Januar 2019, 15:17:30
Etwas mehr Infos zu den Änderungen gibt es immer hier:
https://svn.fhem.de/trac/log

Ist halt etwas "lowleveliger" mit den entsprechenden Vor- & Nachteilen.
Titel: Antw:Changelog gewünscht mit mehr Infos
Beitrag von: betateilchen am 03 Januar 2019, 15:49:40
Exakt die gleichen Informationen gibt es auch hier im Forum...

https://forum.fhem.de/index.php/board,57.0.html
Titel: Antw:Changelog gewünscht mit mehr Infos
Beitrag von: czcbe am 04 Januar 2019, 10:04:51
Stand heute, eines von vier Updates ist beschrieben:

Zitatfhem
List of new / modified files since last update:
UPD ./CHANGED
UPD FHEM/00_MQTT2_CLIENT.pm
UPD FHEM/14_CUL_WS.pm
UPD FHEM/49_SSCam.pm
UPD FHEM/98_MSwitch.pm

New entries in the CHANGED file:
  - bugfix:  49_SSCam: fix problem with some older SMTP SSL module


Danke, die genannten Links machen mich schon halb glücklich, wenn auch meiner Meinung nach das Changelog innerhalb FHEM damit die Wirkung verliert, die es haben könnte. Daher hat es auf der Wunschliste mit dem Wunsch nach mehr Infos durchaus Berechtigung.
Titel: Antw:Changelog gewünscht mit mehr Infos
Beitrag von: Byte09 am 04 Januar 2019, 11:51:07
Zitat von: czcbe am 04 Januar 2019, 10:04:51
Stand heute, eines von vier Updates ist beschrieben:


Danke, die genannten Links machen mich schon halb glücklich, wenn auch meiner Meinung nach das Changelog innerhalb FHEM damit die Wirkung verliert, die es haben könnte. Daher hat es auf der Wunschliste mit dem Wunsch nach mehr Infos durchaus Berechtigung.

nunja , der Hinweis im Board 'Hinweise für Entwickler ' ist halt folgender:
ZitatPflege bitte die CHANGED-Datei, wenn Du etwas änderst, was voraussichtlich größere Auswirkungen haben wird. Kleine Fixes und Doku-Updates brauchst Du nicht zwingend zu vermerken.
... vermutlich u.a. daher oft keine Einträge - zumindest handhabe ich es so .

gruss Byte09
Titel: Antw:Changelog gewünscht mit mehr Infos
Beitrag von: betateilchen am 04 Januar 2019, 15:46:30
Ich trage da auch nur dann etwas ein, wenn es wirklich funktional etwas verändert. Und das ist völlig regelkonform.

Titel: Antw:Changelog gewünscht mit mehr Infos
Beitrag von: czcbe am 08 Januar 2019, 08:53:15
Stand heute, ich vermisse z. Bsp. bei CUL_HM aussagekräftige Angaben, das ist ja doch nicht nur ein "kleiner" Fix:

Zitatfhem
List of new / modified files since last update:
UPD ./CHANGED
UPD ./MAINTAINER.txt
UPD FHEM/00_MQTT2_CLIENT.pm
UPD FHEM/10_CUL_HM.pm
UPD FHEM/34_ESPEasy.pm
UPD FHEM/70_ONKYO_AVR.pm
UPD FHEM/98_freezemon.pm
UPD FHEM/HMConfig.pm

New entries in the CHANGED file:
  - change:  70_ONKYO_AVR: clearing screenItemCxxx readings on page update
Titel: Antw:Changelog gewünscht mit mehr Infos
Beitrag von: vbs am 08 Januar 2019, 11:02:16

10_CUL_HM:improve modelForce startup, remove some bugs
10_CUL_HM:introduce modelForce, correct message repeat for burst devices