EDOMI-Releases/Updates | Aktuell: Version 2.03

[gaert]

Offensichtlich hast Du recht Und wenn die Hilfe erstmal fertig ist... Oha! Dann kann dieses Unterforum vermutlich sofort geschlossen werden, da überflüssig

[mwKNX]

Also Christian, wenn die Leute schon über die Ringe in der Statusseite meckern, dann muss der Rest so gut sein, dass es da nichts mehr zu meckern gibt.

[coliflower]

Sieht vieeeel besser aus als der jetzige grüne Ring ;-)
Nur der dunkelgraue Ring um EDOMI sieht noch ein wenig, hmmm, „benachteiligt aus“ … so, du wolltest das jemand jammert

[Robby]

Sieht doch gut aus

[gaert]

Die Statusseite sieht demnächst so aus (das gibt wieder Mecker...):

Bildschirmfoto 2016-05-27 um 19.29.23.png

[mwKNX]

Die Hilfe ist jetzt zu ca. 70% fertiggestellt, alles Wesentliche ist (fast) fertig - jetzt sind diverse Details und allgemeine Hilfestellungen an der Reihe.

Nur noch 30% und du kannst wieder von etwas anderem als Hilfetexten träumen...

[gaert]

Zunächst wird man nur einzelne Seiten ausdrucken können (Browser) - an eine Exportfunktion der gesamten Hilfe habe ich durchaus gedacht, aber zunächst wieder verworfen: Die Hilfe ist eine Inline-Hilfe und kein Handbuch

Suchfunktion folgt noch (später), eine Versionsverwaltung werde ich mir allerdings ersparen. Falls sich etwas ändert werde ich im Changelog darauf hinweisen.

[Robby]

Zeitplan: Vermutlich noch 1-2 Wochen (maximal)...

Dann nehme ich mir am besten in 1-2 Wochen nichts vor....

Wird die "Hilfe" nur eine Onlinehilfe wie in #841 zu sehen ist sein oder kann man den kompletten Inhalt auch ausdrucken...so eine Exportoption als pdf?
Markiere mir gerne Stellen entweder in OneNote bzw. oder ausgedruckt.
Gibt es auch eine Möglichkeit Texte die du neu erstellst oder veränderst zu suchen?

[gaert]

Kurzes "Update": Die Hilfe ist jetzt zu ca. 70% fertiggestellt, alles Wesentliche ist (fast) fertig - jetzt sind diverse Details und allgemeine Hilfestellungen an der Reihe. Zum Schluss werde ich dann noch die PDF-"Doku" durch eine Installationsanleitung und "Erste Schritte" ersetzen - dann geht das Update endlich raus

Zeitplan: Vermutlich noch 1-2 Wochen (maximal)...

[starwarsfan]

Tools wie Doxygen wären m.M.n. hier im Edomi-Fall lediglich für die automatische Dokumentation der LBS zu gebrauchen. Und auch dort stellt sich das Problem, ob das durch die etwas spezielle Syntax innerhalb der LBS-Files überhaupt brauchbar funktioniert...

[DiMa]

Tools wie Doxygen gibt's schon ewig und die waren noch nie dafür gedacht, eine Programm-/Anwendungs-/Applikationsbeschreibung zu generieren. Doxygen kann Code prima dokumentieren, so dass ein Programmierer einfacherer nachlesen kann, was eine Funktion macht, welche Methoden definiert sind, welche Übergabewerte benötigt werden oder wie eine Klasse strukturiert ist usw.

Was damit grundsätzlich nicht geht - jedenfalls nicht, ohne dafür dann doch wieder eigene Dokumente/Dateien anzulegen - ist die Beschreibung, wie man Programmfunktionen nutzt, die mehr als eine Funktion auf Codelevel erfordern. Z.B. das Anlegen eines Benutzers in Edomi, die Tatsache, dass man für Visus getrennt Benutzer anlegen muss usw.

@gaert: Als jemand, der tagtäglich mit Dokumentation aus Doxygen & Co. hantieren muss: Bitte so weitermachen wie bisher. Ich will nicht für Edomi die Dokumentation des Sourcecodes lesen müssen, um meine Jalousien auf zu kriegen

[eib1607]

gaert : mein letztes Projekt bestand as 7388 Dateien (habs grad mal mit dir /s zählen lassen). .c,.h,.php,.css,.html,.xml,.cpp,.hpp, .ini (ja gibts noch) usw. Das ist ja der Vorteil von Doxygen. Du legst in der Konfig fest welche Dateien er parsen soll und dann wühlt er ALLE durch. Er erstellt dir, wenn du willst, sogar abhängigkeiten der Dateien zueinander dar . Seit ich das benutze spare ich jede menge Zeit denn wenn ich für einen Fix x Dateien anfassen muss, muss ich das nicht mehr irgendwo festhalten er zeigt es automatisch an .... Einen Blick sollte dir das durchaus mal wert sein ....

[mwKNX]

Das ist ja mal ein eine tolle Neuerung!

[NorbertB]

Noch eine Neuerung: Die Hilfe kann demnächst eigenständig in einem Extra-Browserfenster geöffnet und bedient werden - somit kann die Hilfe quasi nebenher immer geöffnet bleiben zum Nachschlagen usw.

Grossartig, ich sag jetzt schonmal Danke

[gaert]

Danke für den Tipp, aber das wäre in diesem Fall nicht wirklich eine Hilfe - EDOMI besteht ja aus sehr vielen unterschiedlichen Dateien, da bin ich zu Fuss schneller (schreiben muss ich ja so oder so).