Vermutlich geht es nur mir so, aber teilweise wären elektr. Anschlusspläne praktisch.

z.B. Eingänge lesen -> im Netz findet man viele verschiedene Anschlüsse (mit Widerstand, ohne Widerstand, 5V durchschalten oder GND,...)

Didi wrote:

Ich wäre ja bereit eine Doku zu machen,aber dafür brauche auch ein paar Anregungen von Euch.

Den SHC würde ich als aller erstes in Betracht ziehen.

Die ganzen Funktionen mal erklären ...

Gerade diese Funktionen mit dem Puchbullet oder wie auch immer, da seh ich gar nicht durch.

Das hier jetzt zur Allgemeinheit (nicht das sich gleich wieder Leute angep... fühlen)

Was die externen Sensorsender usw. angeht, sollte man schon aus den Scripten das wichtigste erkennen können.
Bzw. auf den von Premo erstellten Platienen nachvollziehen können.

Diese (ich bin zu faul, selber zu Suchen Mentalität geht mir irgendwie auf den Nerv)

ein bisserl Eigeninitiative muss schon sein.

Wenn dann Fragen noch über bleiben wird gern geholfen.

Didi hau rein.

Dokus erstellen hasse ich wie die Pest. Weil, man denk und handelt anders als man es Aufschreiben kann.

Oder man sagt einfach was für Dokus man haben möchte, dann werden die erstellt. Oder?

wie wäres es einfach mit einen "wiki" für shc ?

@Didi
Ich finde es gut das du dich bereit erklärt hast die Dokumentation zu übernehmen. Solltest du Unterstützung benötigen oder Fragen zu bestimmten Funktionen haben, kannst du dich auch gern bei mir melden.

Ein Wiki gibt es schon seit Ewigkeiten auf GitHub -> Home · agent4788/SHC_Framework Wiki · GitHub. Da ist auch das bearbeiten freigeben, ihr müsstet euch nur auf GirHub registrieren. Wenn der Wunsch nach einem Unabhängigen WIki da ist könnte ich auch ein Mediawiki o.ä. bereit stellen.

Eventuell wäre auch eine Videoanleitung ein guter Mittelweg, das könnte sogar verständlicher sein als eine 3m lange Seite die man zuerst durcharbeiten muss. Auch das kann man ja in Kategorien Teilen (z.B.: Funktionsüberblick [zum anfüttern was überhaupt geht], Installation, Schaltserver Einrichten, Sensordaten ins SHC bringen, Schaltfunktonen einrichten ...). EIn YouTube Vidoe zur Installation vom SHC 1.x gab es schon einmal, das finde ich nur leider nicht mehr.

Didi wrote:

Man sollte sich die Frage stellen ob man schon damit anfängt die Software zu dokumentieren von SHC3 mit Doxygen oder Javadoc.

Der Quellcode wird schon mit Javadoc (bzw. bis SHC 2 mit PHPdoc) Dokumentiert, aber auf API ebene. Zum Beispiel die Schnittstelle zum schalten der Edimax Steckdosen: SHC_Application_Framework/SP1101.java at master · agent4788/SHC_Application_Framework · GitHub , daraus kann man dann automatisch die bekannten Javadoc HTML Seiten erstellen lassen.

Ich fände es gut wenn es eine ausführliche Dokumentation von SHC geben würde. In meinem Fall, ich bin Windows-Nutzer von der allerersten Minute habe von Linux überhaupt keine Ahnung.
Ich hatte mit C-Control (Basic) die ganzen Jahre gearbeitet, da die Teile vor kurzem nach 15 Jahren Dauerbetrieb kaputt gingen kam ich zum Arduino und schließlich zum Raspberry. Hätte es bei dieser Umstellung mal vielleicht eine solche ausführliche Dokumentation gegeben würde man vielleicht die ganze Sache besser verstehen, auch wenn sich erst recht diese Dokumentation zusätzlich auf die Installation von SHC bezieht.
Ich musste mich mühsam durch die verschiedensten Links quälen um mir die nötigen Informationen zu beschaffen was sehr oft verwirrend war. Nur ein Beispiel was ist --install git-core-- oder was ist ein ---apache --- was wollen die eigentlich von mir ???
Jetzt sagt natürlich jeder kauf dir doch erst mal ein Handbuch zu Linux hätte derjenige auch Recht damit aber im Handbuch gibt es z.B. keine Dokumentation zu SHC und Beispiele oder Erklärungen auf eine Sache die man speziell nutzen möchte sind da sehr hilfreich und erklären eventuell andere Sachen gleich mit.

Grundsätzlich wäre eine Dokumentation des SHC eine tolle Sache. Allerdings sollten die Dokumentationen von Peripherie getrennt erfolgen. Gerade wenn es um solche Dinge wie Pushbullet geht, oder auch um Hatdwareerweiterungen.
Und gerade bei letzterem, wie auch die Platinen die hier im Forum vorgestellt wurden, wären ausführliche Dokumentationen äußerst hilfreich, da sich dann auch viele Fragen erst gar nicht stellen würden.

Auch eine gepflegte Liste von funktionierenden Erweiterungen wär mal nicht schlecht.
Könnte ja im Zusammenhang mit Dokumentationen erfolgen.


Gesendet von iPhone mit Tapatalk

eventuell könnte man ja auch mal die hardware liste aus dem Archiv wieder raus fischen, irgendwo anpinnen, das die immer gefunden werden kann und dann wie damals immer weiter fortführen.

zumindestens für funksteckdosen war das mit kosten, Bezugsquellen und verwendeten Protokollen recht gut beschrieben.

Dazu brauchts aber auch erst mal n Boardmoderator, der dann eventueel Themenüberschriften anpasst und in die richtigen Bereiche verschiebt.

Das können wir nicht auch noch alles Agent47 überhelfen.

Das einzig richtige wäre eigentlich wenn es nur einen Thread gibt, der angepinnt wird und wo auch nur ein, zwei oder drei Leute reinschreiben können (sonst wird das wieder ein Endlosdiskussion).
Und wenn dort was hinzugefügt werden soll, z.B: Hardwarequellen, Baupläne, Erweiterungsanleitungen, etc. dann muss das per PN an einen dieser Leute, und die müssen dann den Thread pflegen.

Alles andere werden wieder unübersichtliche Diskussionen wo auch jeder alles so darstellt, wie er es für richtig hält und man wieder sucht und such.

das wäre dann eher ei fall für ein Wiki, dafür ist ein Forum nicht unbedingt der richtige Ort.

Jup.

Im GitHub Wiki gibt es schon etwas ähnliches -> github.com/agent4788/SHC_Frame…iki/Unterstützte-Hardware

Nagele doch mal den Link dahin irgendwie oben in Forum fest an.

Ich werde mich doch mal da anmelden und versuchen etwas mit anzupassen.

Im Forum fände ich es deswegen besser, weil es dann auch über die Forensuche gefunden werden kann.

ok,
n Wiki im Forum.
für mich selber habe ich ein MediaWiki laufen, auf meinem Eisfair Server.
Macht sich als Notitzbuch ganz gut, aber eins im Öffentlichkeitsbereich bereiben / betreuen. Neee
Ich nicht.

Auch da muss ne gute Struktur rein.

@DieterWo
Ein Ordentlich aufgeteiltes Wiki macht auch eine Suche weitestgehen überflüssig. Vor allem das auf GitHub biete viele mglichkeiten, durch den Umfangreichen Markdown Support finde ich das besser als ein Mediawiki.