Dokumentation

Home Automation macht Spaß. (Und ist praktisch und wichtig und energiesparend und überhaupt und ausserdem, sonst würden wir’s ja nicht machen.)

  • Dokumentation für uns selbst
    Gedankengänge – warum habe ich diesen Weg gewählt um jene Problematik zu lösen
  • Dokumentation zur Unterstützung für andere
    Wir sind kurzfristig nicht erreichbar, fallen krankheitsbedingt kurz aus – das System soll bedienbar bleiben, eventuelle Fragen beantwortet werden
  • Das System wird von jemandem anderen übernommen
    Aus welchen Gründen auch immer – wie kann ein Nachfolger sich möglichst schnell einarbeiten, wie kann er das System am Laufen halten, wo liegen die “Leichen im Keller”

Papier oder doch lieber digital?

Meine persönliche Meinung – beides.
Passwörter und Zugänge sowieso schriftlich in einem versiegelten Kuvert an einer vereinbarten Übergabestelle.

Aber auch eine kurze Mappe mit den wichtigsten Grundzügen ist im Falle des Falles für die meisten Menschen mit weniger Berührungsängsten verbunden als ein Zugang zu einem digitalen Archiv.

Nichtsdestotrotz plädiere ich bei einem hochkomplexen Smart Home für eine durchgängige exakte digitale Dokumentation, fein säuberlich an einem zentralen Ort geführt.

Für uns hat sich – nach langem Herumprobieren eine Mediawiki als das passendste Instrument herausgestellt. Siehe unten – wir haben auf WordPress umgestellt.
Jedes Thema bekommt eine eigene Seite, Gedankengänge werden ebenso dokumentiert wie Zugänge oder auch “lessons learned”. Ja, auch Fehlversuche gehören dokumentiert. Und eine FAQ ist ebenfalls eine exzellente Idee.

WordPress als Dokumentation

Wir haben die Mediawiki abgelöst. Sie war praktisch, aber Wartung und Updates waren – nennen wir’s mühsam.

Nach ziemlich langer Suche und vielen Testsystemen haben wir uns dafür entschieden, eine einfache WordPress Page als Dokumentationssystem zu verwenden. Warum ausgerechnet WordPress?

  • Pflege der Beiträge
    Auch für den Gelegenheitsbenutzer schnell und einfach zu bedienen,
    neue Beiträge können einfach angelegt werden,
    bestehende Beiträge problemlos editiert
  • Media Files
    Alle üblichen Medientypen können problemlos ins System integriert werden,
    Manuals und Screenshots werden zentral gepflegt und sind jederzeit zur Hand
    FileBird erleichtert uns die Strukturierung hier ungemein
  • Suche
    Relevanssi leistet hier gute Dienste – schnell, gut konfigurierbar und findet die gewünschte Info
  • Updates & Backup & Export
    Supereinfach zu handhaben!

Disziplin

Um als Dokumentation hilfreich zu sein ist es unerlässlich diese auch aktuell zu halten. Was sich zuerst nach Disziplin und Arbeit anhört wird im Laufe der Zeit zu einem netten Task, eine Art krönender Abschluß einer neuen Funktionalität.

Es hat sich ebenfalls bewährt auch Familienmitglieder mit der Aktualisierung der Dokumentation zu betrauen, dadurch sind sie im Fall des Falles mit den Werkzeugen vertraut und finden sich leichter zurecht.

Wie man im Bild nebenan sieht sind kleine Hilfsmittel ein weiteres nettes Spielzeug um die Dokumentation einfach und leicht up-to-date zu halten (kleiner 3D Barcode Scanner zB um HomeMatic IP Codes oder auch LoRaWan Codes zu scannen).

Ähnliche Beiträge

  • Woox ZigBee Gartenventil

    Ich hab’ ein neues Spielzeug! Der Lebkuchenbaum braucht eine schnelle AdHoc Bewässerung, eine Leitung ist dorthin nicht verlegt also muß interimsmäßig ein Gartenschlauch überirdisch gelegt werden – der Lebkuchenbaum ist permanent durstig, also bekommt auch er wieder einen LoRaWan Bodenfeuchtesensor…

  • HomeMatic

    Im Oktober 2016 zog die erste CCU2 von HomeMatic bei uns ein, nach einigen zögerlichen Versuchen wurde das Ding ohne große Begeisterung eingemottet und geriet vorerst in Vergessenheit. Erst 2018 mit dem Release der CCU3 stiegen wir dann mit Volldampf…

  • Energiemessung

    Wir wurden auf Smartmeter umgestellt – das per se ist ja nichts Ungewöhnliches. Das Lästige dran ist – kaum war alles eingerichtet, die Schnittstelle funktionierte sauber – beschlossen die Netzbetreiber dasses ein guter Zeitpunkt wäre, den Smartmeter nochmals zu tauschen….

  • Eine Olive wird verkabelt

    Die Technik Die Temperatur wird mittels eines doppelten Temperaturfühlers nahe der Wurzeln und an der Oberfläche des Hügels erfaßt und per LoRaWan gesendet, die Heizung danach mittels HomeMatic IP geregelt (und auch die Leistung erfaßt). Sollte es überraschend in einem…

  • Automatische Lichtsteuerung

    Vorüberlegungen – was alles hat Einfluß auf die Lichtsituation? input_boolean_ps_raum Logische Matrix aus kombinierten Präsenz- und Bewegungsmeldern und manuell auslösbaren Timern input_boolean_ps_prohibitor_raum Gibt es etwas, das das Einschalten der Beleuchtung verhindert (verhindern soll)? binary_sensor_raum_hell Schwellwertsensor über die Helligkeit im Raum…

  • Grocy – das perfekte ERP für Katzen?

    Grocy is a web-based self-hosted groceries & household management solution for your home. grocy.info Warum eine digitale Erfassung? Für den perfekten Überblick über den Katzenfuttervorrat brauchen wir eine Lösung, die sowohl einfach einzurichten als auch komfortabel und einfach zu benutzen…