Neuigkeiten:

Am Sonntag den 8.12.2024 kann es ab ca. 8:00 Uhr zu kurzzeitigen Einschränkungen / Ausfällen bei den Diensten des FHEM Vereines kommen.
Die Server müssen mal gewartet und dabei neu gestartet werden ;)

Hauptmenü

Entfernen von meintechblog.de von fhem.de

Begonnen von CoolTux, 23 Februar 2017, 19:19:07

Vorheriges Thema - Nächstes Thema

Otto123

Moin,

mir ging es nicht darum Kritik an einem Blog oder an der Unvollkommenheit der Beiträge im Internet zu üben.
Aber unter der Rubrik Dokumentation für FHEM gehört meiner Meinung nach eine Reihenfolge / Auflistung wo der Benutzer sich orientieren kann wie er zu Informationen kommt. Das wichtigste ist aus meiner Sicht die commandref, da die vom Modulentwickler mit den grundlegenden Informationen gespeist wird.
Die sollte unter Dokumentation deshalb eindeutig an erster Stelle stehen.

Gruß Otto
Viele Grüße aus Leipzig  ⇉  nächster Stammtisch an der Lindennaundorfer Mühle
RaspberryPi B B+ B2 B3 B3+ ZeroW,HMLAN,HMUART,Homematic,Fritz!Box 7590,WRT3200ACS-OpenWrt,Sonos,VU+,Arduino nano,ESP8266,MQTT,Zigbee,deconz

HCS

Zitat von: klimachristoph am 27 Februar 2017, 07:42:35
Wir möchten euch daher herzlich einladen, uns die Themen, die ihr für veraltet haltet, mitzuteilen und uns gerne einen Hinweis zu geben, was wir aktualisieren sollten. Wir hatten bisher immer ein offenes Ohr und das wird sich auch nicht so schnell ändern.
Ein maintainer in FHEM entwickelt und pflegt Module, schreibt in denen die commandRef, die die technischen Möglichkeiten des Moduls beschreibt, leistet Support im FHEM-Forum (beides ist Pflicht) und schreibt und pflegt u.U. noch weitergehende Informationen im FHEM-Wiki.

Soll er nun tatsächlich alle Blogs (es gibt ja noch eine ganze Reihe mehr), die dazu etwas schreiben, ausfindig machen, korrekturlesen und die Doku dort auch noch korrigieren und aktualisieren?
Wenn jemand (egal ob Blog oder sonstwo) eine technische Dokumentation erstellt und veröffentlicht, dann ist es auch seine Aufgabe, für die Richtigkeit und Aktualität zu sorgen.

Aber wie in vorhergehenden Beiträgen schon angeklungen, bin auch ich der Meinung, dass technische Dokumentation zu FHEM-Modulen in die commandRef und das FHEM-Wiki gehört.

Wenn Blogs beschreiben, was man tolles mit FHEM machen kann oder gemacht hat, dann ist das super, aber ein anderer Fall als das, worüber wir gerade diskutieren.

betateilchen

#17
Zitat von: HCS am 27 Februar 2017, 09:08:41
Ein maintainer in FHEM entwickelt und pflegt Module, schreibt in denen die commandRef, die die technischen Möglichkeiten des Moduls beschreibt, leistet Support im FHEM-Forum (beides ist Pflicht) und schreibt und pflegt u.U. noch weitergehende Informationen im FHEM-Wiki.

... und schlägt sich anschließend hier im Forum mit Anwenderproblemen rum, die daraus resultieren, dass die Leute sich auf die veralteten Informationen in irgendwelchen externen Quellen (in vielen Fällen eben meinxxxxblog) verlassen haben. Wenn ich dann von einem User lese "aber es steht doch so auf meinxxxxblog.de" steigt in mir die Galle hoch und ich frage mich, wo die Taliban eigentlich sind, wenn man sie mal gebrauchen könnte.

Die Zeit, die ich dafür aufwende, solche Anwenderprobleme zu lösen, würde ich lieber in andere Aufgaben stecken.

Nicht nur, dass man mit abgeschriebenen Informationen versucht zu punkten, die Dinge werden weder auf ihre Richtigkeit geprüft, noch werden die Informationen aktualisiert. FHEM ist nicht statisch, das entwickelt sich täglich weiter. Deshalb ist solch ein Blog wenig zielführend.

Schlimmstes Beispiel: "FHEM auf Raspberry in einer Stunde einrichten"




Nun haben wir genug Suchwörter für diese externe, mit Werbelinks vollgestopfte Webseite generiert. Können wir diesen Thread jetzt bitte schließen?
-----------------------
Formuliere die Aufgabe möglichst einfach und
setze die Lösung richtig um - dann wird es auch funktionieren.
-----------------------
Lesen gefährdet die Unwissenheit!

CoolTux

Gerne komme ich dieser Bitte nach. Der Intention des Threads wurde ja Rechnung getragen.
Du musst nicht wissen wie es geht! Du musst nur wissen wo es steht, wie es geht.
Support me to buy new test hardware for development: https://www.paypal.com/paypalme/MOldenburg
My FHEM Git: https://git.cooltux.net/FHEM/
Das TuxNet Wiki:
https://www.cooltux.net