Dokumentationsstruktur: Unterschied zwischen den Versionen
KKeine Bearbeitungszusammenfassung |
Krikan (Diskussion | Beiträge) KKeine Bearbeitungszusammenfassung |
||
| Zeile 3: | Zeile 3: | ||
Nachfolgend ein kurzer Überblick über diese verschiedenen Quellen: | Nachfolgend ein kurzer Überblick über diese verschiedenen Quellen: | ||
=[http://www.fhem.de FHEM]= | ==[http://www.fhem.de FHEM]== | ||
Hier gibt es Allgemeines zu FHEM, sowie Installationsanleitungen. | Hier gibt es Allgemeines zu FHEM, sowie Installationsanleitungen. | ||
={{Link2CmdRef}}= | =={{Link2CmdRef}}== | ||
Bei einem auftretenden Problem sollte immer zuerst in der '''CommandRef''' nachgesehen werden, wie Module oder FHEM-Befehle einzusetzen sind. Auch neue Funktionen usw. werden hier von den Modulautoren tagesaktuell dokumentiert. Diese Dokumentation ist in der Regel so gestaltet, dass danach | Bei einem auftretenden Problem sollte immer zuerst in der '''CommandRef''' nachgesehen werden, wie Module oder FHEM-Befehle einzusetzen sind. Auch neue Funktionen usw. werden hier von den Modulautoren tagesaktuell dokumentiert. Diese Dokumentation ist in der Regel so gestaltet, dass danach | ||
* FHEM-Befehle (''FHEM commands'') verstanden und ausgeführt werden können; | * FHEM-Befehle (''FHEM commands'') verstanden und ausgeführt werden können; | ||
| Zeile 14: | Zeile 14: | ||
'''TIPP:''' Bitte keine Beschwerden über "fehlende deutschsprachige Dokumentation". Wer diese vermisst, sollte sie einfach durch Übersetzung der englischsprachigen Commandref erstellen und dem Modulautor zusenden - er freut sich in der Regel über die Zuarbeit. Wer der Modulautor ist, erfährt man ebenfalls aus der Dokumentation, dafür gibt es die Datei [https://www.fhem.de/MAINTAINER.txt MAINTAINER.txt ]. | '''TIPP:''' Bitte keine Beschwerden über "fehlende deutschsprachige Dokumentation". Wer diese vermisst, sollte sie einfach durch Übersetzung der englischsprachigen Commandref erstellen und dem Modulautor zusenden - er freut sich in der Regel über die Zuarbeit. Wer der Modulautor ist, erfährt man ebenfalls aus der Dokumentation, dafür gibt es die Datei [https://www.fhem.de/MAINTAINER.txt MAINTAINER.txt ]. | ||
=FHEMWiki= | ==FHEMWiki== | ||
Die hier gerade betrachtete Seite steht im FHEMWiki. Mit dem Link links oben gelangt man auf die Hauptseite, die einen guten Einstieg darstellt. Die Artikel im FHEMWiki stammen teilweise von den Modulautoren selbst, viele werden aber von Anwendern für andere Anwender erstellt. Dementsprechend ist die Aktualität und Qualität der Artikel unterschiedlich. | Die hier gerade betrachtete Seite steht im FHEMWiki. Mit dem Link links oben gelangt man auf die Hauptseite, die einen guten Einstieg darstellt. Die Artikel im FHEMWiki stammen teilweise von den Modulautoren selbst, viele werden aber von Anwendern für andere Anwender erstellt. Dementsprechend ist die Aktualität und Qualität der Artikel unterschiedlich. | ||
'''TIPP:''' Für Verbesserungsvorschläge zum FHEMWiki besteht ein eigener [https://forum.fhem.de/index.php/board,80.0.html Bereich im Forum]. | '''TIPP:''' Für Verbesserungsvorschläge zum FHEMWiki besteht ein eigener [https://forum.fhem.de/index.php/board,80.0.html Bereich im Forum]. | ||
=[http://forum.fhem.de/ Forum]= | ==[http://forum.fhem.de/ Forum]== | ||
Im Forum stellen manche Entwickler, insbesondere auch solche (noch) inoffizieller Module, weitere Informationen zur Verfügung. Nützliche Infos zum Forum selbst sind in den [https://forum.fhem.de/index.php/board,18.0.html angepinnten Beiträgen im Anfängerbereich] zu finden, dort finden sich auch Hinweise zum Umgang mit der forumsinternen Suchfunktion. | Im Forum stellen manche Entwickler, insbesondere auch solche (noch) inoffizieller Module, weitere Informationen zur Verfügung. Nützliche Infos zum Forum selbst sind in den [https://forum.fhem.de/index.php/board,18.0.html angepinnten Beiträgen im Anfängerbereich] zu finden, dort finden sich auch Hinweise zum Umgang mit der forumsinternen Suchfunktion. | ||
'''TIPP:''' Erst die Suchfunktion benutzen, dann eine eigene Frage stellen. Die meisten Probleme treten nicht zu ersten Mal auf, sondern sind - kein Wunder bei ca. 20.000 Teilnehmern - schon einmal behandelt worden. | '''TIPP:''' Erst die Suchfunktion benutzen, dann eine eigene Frage stellen. Die meisten Probleme treten nicht zu ersten Mal auf, sondern sind - kein Wunder bei ca. 20.000 Teilnehmern - schon einmal behandelt worden. | ||
=Internet, Blogs usw.= | ==Internet, Blogs usw.== | ||
Bei Informationen, die aus anderen Quellen stammt, sollten Hilfesuchende selbst prüfen, inwieweit diese aktuell und von guter Qualität sind. Dabei ist zu bedenken, dass die betreffenden Autoren eventuell auch Interessen verfolgen, die nicht deckungsgleich sein müssen mit denen der FHEM-Community. | Bei Informationen, die aus anderen Quellen stammt, sollten Hilfesuchende selbst prüfen, inwieweit diese aktuell und von guter Qualität sind. Dabei ist zu bedenken, dass die betreffenden Autoren eventuell auch Interessen verfolgen, die nicht deckungsgleich sein müssen mit denen der FHEM-Community. | ||
Version vom 9. Februar 2018, 21:37 Uhr
Die zu FHEM verfügbare Dokumentation ist auf verschiedene Quellen aufgeteilt.
Nachfolgend ein kurzer Überblick über diese verschiedenen Quellen:
FHEM
Hier gibt es Allgemeines zu FHEM, sowie Installationsanleitungen.
commandref
Bei einem auftretenden Problem sollte immer zuerst in der CommandRef nachgesehen werden, wie Module oder FHEM-Befehle einzusetzen sind. Auch neue Funktionen usw. werden hier von den Modulautoren tagesaktuell dokumentiert. Diese Dokumentation ist in der Regel so gestaltet, dass danach
- FHEM-Befehle (FHEM commands) verstanden und ausgeführt werden können;
- Gerätemodule (Device Modules) verstanden werden, so dass mit ihnen ein FHEM-Device definiert, konfiguriert und bedient werden kann;
- Helpermodule (Helper Modules) verstanden und konfiguriert werden können.
Für die an der Entwicklung von FHEM beteiligten Softwareentwickler (Modulautoren) gibt es eine einzige verpflichtende Vorgabe: Offizielle Module müssen über eine englischsprachige CommandRef verfügen. Dies ist daher die wichtigste Quelle für Informationen rund um ein Modul.
TIPP: Bitte keine Beschwerden über "fehlende deutschsprachige Dokumentation". Wer diese vermisst, sollte sie einfach durch Übersetzung der englischsprachigen Commandref erstellen und dem Modulautor zusenden - er freut sich in der Regel über die Zuarbeit. Wer der Modulautor ist, erfährt man ebenfalls aus der Dokumentation, dafür gibt es die Datei MAINTAINER.txt .
FHEMWiki
Die hier gerade betrachtete Seite steht im FHEMWiki. Mit dem Link links oben gelangt man auf die Hauptseite, die einen guten Einstieg darstellt. Die Artikel im FHEMWiki stammen teilweise von den Modulautoren selbst, viele werden aber von Anwendern für andere Anwender erstellt. Dementsprechend ist die Aktualität und Qualität der Artikel unterschiedlich.
TIPP: Für Verbesserungsvorschläge zum FHEMWiki besteht ein eigener Bereich im Forum.
Forum
Im Forum stellen manche Entwickler, insbesondere auch solche (noch) inoffizieller Module, weitere Informationen zur Verfügung. Nützliche Infos zum Forum selbst sind in den angepinnten Beiträgen im Anfängerbereich zu finden, dort finden sich auch Hinweise zum Umgang mit der forumsinternen Suchfunktion.
TIPP: Erst die Suchfunktion benutzen, dann eine eigene Frage stellen. Die meisten Probleme treten nicht zu ersten Mal auf, sondern sind - kein Wunder bei ca. 20.000 Teilnehmern - schon einmal behandelt worden.
Internet, Blogs usw.
Bei Informationen, die aus anderen Quellen stammt, sollten Hilfesuchende selbst prüfen, inwieweit diese aktuell und von guter Qualität sind. Dabei ist zu bedenken, dass die betreffenden Autoren eventuell auch Interessen verfolgen, die nicht deckungsgleich sein müssen mit denen der FHEM-Community.
TIPP: Bevor man Fragen zu derartigen Informationsquellen im Forum stellt, sollte man diese gegen die innerhalb der oben aufgeführten Quellen gegengeprüft haben.