Meeting für ioBroker Core/Dev/Admin 08.09.20 20:30

[ldittmar]

@Jey-Cee Das klingt auch gut! Wir machen es dann bis 22:30, beenden das Thema und schieben alles weitere auf das nächste Meeting, der dann ggf. auch ein Monat später passieren kann.

[arteck]

@ldittmar Ohh ja timebox ..das ist gut

[Jey Cee]

Themenvorschlag:

• Umbenennung von latest nach Beta, Übergangs weise Beta(latest)

[Dutchman]

Umfrage hinzugefügt wann das nächste treffen stattfinden sollte, bitte abstimmen damit wir planen koennnen

[apollon77]

Hatten wir nicht noch mehr Themen wo wir "setzen wir auf die liste" gesagt hatten?

[UncleSam]

Wie sieht's mit Übersetzungen aus? Das ist ja im Thema zum letzten Meeting ausführlich diskutiert worden - mit einem Vorschlag von @Bluefox.

[apollon77]

Und mit AlCalzone hatten wir eine DIksussion zu "welche Versionen am besten in io-package lassen" um das idealerweise im release script zu automatisieren

[Dutchman]

Bitte wünsch Termin eintragen : https://doodle.com/poll/u4wassupgmdzznwe

[carsten04]

Themenvorschlag: einheitlicher Dokustandard für Adapter. Idee: Nutzung von VuePress. Vorteile: einfaches Handling und Integration in z.B. GitHub Pages. Habe ich bei meinem milight-smart-light Adapter umgesetzt, könnte z.B. so aussehen: Doku milight-smart-light Adapter.

[Homoran]

@carsten04 sagte in Online Meeting für ioBroker Core/Dev/Admin September Edition:

Themenvorschlag: einheitlicher Dokustandard für Adapter. Idee: Nutzung von VuePress. Vorteile: einfaches Handling und Integration in z.B. GitHub Pages. Habe ich bei meinem milight-smart-light Adapter umgesetzt, könnte z.B. so aussehen: Doku milight-smart-light Adapter.

gefällt mir optisch gut, wie ist es mit der Pflege und der Versions- Verlauf"kontrolle"?
Ist die Einbindung in die Adapterseite im Admin möglich?

[Jey Cee]

@carsten04 aus meiner sicht gibt es da nichts zu Diskutieren, den es gibt schon lange einen Standard -> https://www.iobroker.net/#de/documentation/dev/adapterdocstyleguide.md

[carsten04]

@Homoran Das ganze ist ja im GitHub verortet (wie ein normales Adapter-Projekt), d.h. alle Versionskontrollmechanismen können genutzt werden. Im Admin (index_m.html) fügst Du dann einfach z.B. den folgenden Link ein:

<a target="_blank" href="https://steiger04.github.io/milight-smart-light-doku/">
                    <i class="small material-icons">import_contacts</i>
                    <div style="font-size: x-small">Doku</div>
                </a>
``

[Homoran]

@carsten04 klingt gut, jetzt muss ich mich damit mal näher befassen, ob das außer für die Adapterdoku auch für den Rest brauchbar ist

[carsten04]

@Homoran Man kann mit VuePress fast beliebig skalieren. Ein gutes Beispiel dafür ist die openHAB-Doku, die komplett mit VuePress erstellt wurde.

[Homoran]

@carsten04
Das muss dann @Bluefox entscheiden.
Es wäre dann die dritte Doku-Software. Erst Wordpress, das ließ sich (für mich) relativ leicht bedienen, dann natives MD über github, womit ich so meine Probleme habe. VuePress scheint da wieder für nicht-Devs in kryptischen Befehlen zu "progammieren" sein.
Oder habe ich das im schnellen Überfliegen falsch interpretiert
https://vuepress.vuejs.org/guide/

[carsten04]

@Jey-Cee Der Style-Guide ist ja auch schon super und verweist auf Markdown. Das ist auch die
Basis für VuePress, aber Du bekommst halt noch einen Static-Site-Generator dazu und hast damit eine out of the box Website, die supereinfach wartbar ist und komplett getrennt vom restlichen Adapter-Code gehandelt werden kann. Ich finde schon das es wert ist, darüber einmal nachzudenken und zu diskutieren.

[FredF]

@carsten04 @Homoran
Da ich auch bei so zwei, drei (oder mehr?) Adaptern bei der Doku geholfen habe, möchte ich auch mal meinen Senf dazugeben und für die Einführung von VuPress voten. Habe das zwar noch nie benutzt aber alleine die Möglichkeit einer Navigation spricht dafür.

[Dutchman]

@carsten04 sagte in Online Meeting für ioBroker Core/Dev/Admin September Edition:

Themenvorschlag: einheitlicher Dokustandard für Adapter. Idee: Nutzung von VuePress.

@FredF sagte in Online Meeting für ioBroker Core/Dev/Admin September Edition:

für die Einführung von VuPress voten.

Habe das Thema auf die liste aufgenommen, @carsten04 es wuerde helfen wen du uns während des meetings etwas dazu zeigen könntest wie es aussieht usw.
Vorschlag : TimeBox 15 min

Cheers,

Dutch

[carsten04]

@Homoran Schau Dir mal folgendes an: Doku für milight-smart-light
VuePress erzeugt für Dich wirklich sehr einfach eine statische Seite aus Markdown-Dokumenten. Du mußt also nur Markdown beherrschen, den Rest übernimmt VuePress für Dich. Den Source Markdown findest Du z.B. in den subfoldern /admin, /app, /introduction, /iot, /versionen für mein Projekt. Der Ordner /docs wird dann für Dich von VuePress erzeugt und enthält die statische Seite. Wir könnten halt über VuePress ein einheitliches Layout und auch Struktur für die Adapter vorgeben und der Entwickler muss dann nur noch das Markdown schreiben und anschließend alles auf GitHub Pages publizieren.

[Dutchman]

@carsten04 sagte in Online Meeting für ioBroker Core/Dev/Admin September Edition:

Wir könnten halt über VuePress ein einheitliches Layout und auch Struktur für die Adapter vorgeben und der Entwickler muss dann nur noch das Markdown schreiben und anschließend alles auf GitHub Pages publizieren.

So etwas suche ich schon lange, auch damit wir central miteinander unsere doch inhaltlich vorm geben können.
Momentan liegt alles in md files auf git und wird unsere docu Seite daraus übersetzt und integriert

https://www.iobroker.net/#de/documentation

Vorschlag : Alles weitere dazu bitte in einem separaten topic, dieser hier ist gedacht fürs meeting

Danke !