Betrifft neue Dokumentation

[OliverIO]

Ich habe gesehen, das die adapter-doku (README.md) von github auf englisch übernommen wird und dann maschinell auf deutsch übersetzt wird.
Was wäre die Namenskonvention, um selbst eine deutsche Übersetzung auf github bereitzustellen, so dass es von dort aus dann übernommen werden kann?

Edit: Interessant woher der Link hier oben bei README.md herkommt. Ich habe ihn nicht gesetzt.

[Homoran]

@OliverIO

Was bitte genau?

https://forum.iobroker.net/topic/22994/neue-dokumentation

[OliverIO]

https://www.iobroker.net/#de/adapters/adapterref/iobroker.squeezeboxrpc/README.md

und

https://github.com/oweitman/ioBroker.squeezeboxrpc/blob/master/README.md

[Homoran]

Bitte nichts nachträglich editieren - liest dann kein Mensch mehr, der vorher deinen Post gelesen hat.
Ich hab es nur gesehen, während es sich änderte.

Welcher Link?

in beiden steht nur readme.md

[OliverIO]

auch dein readme.de ist bei mir als link zu sehen, der hier hin führt
https://core2.me/?ref=readme

[Homoran]

@OliverIO
Cool - stay tuned

[OliverIO]

Hier gibt es eine Vorschlag, der aber nicht wirklich von github angenommen wurde.
https://github.com/github/markup/issues/899

Benamung wäre dann
README.md = default english
README.de.md = deutsch
README.fr.md = französisch
usw

[Homoran]

@OliverIO

Im Moment halten wir noch alles unter iobroker.docs gemäß dieser Struktur:

https://github.com/ioBroker/ioBroker.docs/tree/master/docs

Für die final geplante Unterbringung der Adapterreferenz im Readme der Adapterrepos haben wir noch keine endgültige Entscheidung getroffen.

[paul53]

@Homoran Ein erster PR für Grundlagen / States und Datenpunkte ist erstellt.

[paul53]

@Homoran Wofür ist der Punkt Grundlagen / Funktionen gedacht ?

[Homoran]

@paul53
Danke!!

Aber du bist teilweise zu schnell

Ich wollte gerade in dem oberen Bereich das Menü eventuell noch umgestalten.
Da sind wir gerade in der Diskussion.
Einige Menüpunkte wurden schon vor einiger Zeit erstellt und wir wissen nicht mehr weshalb

Kann sein, dass es aus den enums: $functions$ kam

[Homoran]

@Zer0x sagte in ioBroker Installation via cURL nicht möglich:

sind nur teilweise leer.

Was fehlt denn an der verlinkten Anleitung?

[BBTown]

@Homoran ich habe die Installationsanleitung nicht über die Menustruktur finden können

[Homoran]

@BBTown

[BBTown]

@Homoran
Installation - Inroduction -> Platzhalter
Installation - Hardware -> Platzhalter
Installation - Fertigimages - Installation -> Platzhalter
Installation - Virtualisierungsplattformen - Installation -> Platzhalter
Installation - manuelle Installtion - Installation -> Platzhalter

Du glaubst ernsthaft, dass dann noch jemand weiter klickt?

JETZT käme ein Treffer:
Installation - manuelle Installation - Linux-> Doku

Dann gehts es wieder weiter mit:
Installation - Softwareupdates - Installation -> Platzhalter

Bei aller Liebe ... das ist Wahnsinn und frustrierend
Kannst Du die "Platzhalter" nicht "ausgrauen", "abschwächen", vor allem aber HINTEN ANSTELLEN und nicht vornewege nur Platzhalter zu haben bis mal irgend eine Doku wirklich verfügbar ist?

Sorry, ich weiss, dass hier viel Mühe und Engagement drinnen steckt, aber so verschrickt man doch jeden suchenden

[Homoran]

@BBTown

Ich hätte auch nichts dagegen wenn du je eine Anleitung für Docker, Proxmox, Mac und sonst noch was schreibst und als Pullrequest anbietest.
siehe auch: https://forum.iobroker.net/topic/22994/neue-dokumentation

Das würde die leeren Felder schneller füllen.

Leider ist es bei dem jetzigen System nicht ganz so einfach das Menü zu verändern. Dieses musste daher ganz zu Beginn geschrieben werden.
Leider bin ich schon eine ganze Zeitlang krank.

Auch wenn ich von der Intensivstation noch mit dem Handy tippe, klappt es mit der Doku leider nicht ganz so gut

[BBTown]

@Homoran Du weißt hoffentlich, dass ich dich nicht angreifen wollte, lediglich aufzeigen weshalb auch ich nicht fündig wurde ...

Ich wünsche Dir gute Besserung!!
Ich weiß Dein (Euer) Engagament wirklich zu schätzen!!

... ich würde dir das Handy ja wegnehmen, wenn ich dort etwas zu sagen hätte

[Homoran]

@BBTown sagte in Betrifft neue Dokumentation:

Du weißt hoffentlich, dass ich dich nicht angreifen wollte

Ja, aber es ärgert mich selber, dass ich da nicht weiterkomme

@BBTown sagte in Betrifft neue Dokumentation:

ich würde dir das Handy ja wegnehmen,

Das wirst du schön bleiben lassen, was soll ich sonst den ganzen Tag machen.
Aber wenn ich statt einen Link für ein Image zu schicken, das Image runterlade, ist meine Datenrate eh weg.

BTT:
Wie in dem verlinkten Thread geschrieben wird die Doku automatisch generiert.
Damit das funktioniert muss die Struktur vorher existieren.

Ein "ausgrauen" macht es IMHO nicht unbedingt übersichtlicher.

[Jan1]

@Homoran
Ich hatte ja auch schon ein Mecker Thread geöffnet, weil die neue Doku zu derzeit sehr unbrachbar war und eine halbwegs logische Suche für mich nur auf leeren Seiten endete.
Mittlerweile ist das ja besser, so ganz glücklich bin ich aber auch noch nicht. Hab da aber Vertrauen, dass das selbst vom Krankenbett gelöst wird.
Deshalb auch von mir Gute Besserung.

[Homoran]

@Jan1

Danke!
Gottseidank bin ich im Moment auf freiem Fuss und konnte mich vor der nächsten OP erst einmal drücken

Bald kann ich auch wieder (länger) am PC sitzen , dann hoffe ich, dass sich im letzten Jahr nicht zu viel Arbeit zu Hause angessammelt hat und ich wieder in die vollen starten kann.

Mit Meckern, wenn es denn produktiv ist, habe ich überhaupt keine Probleme.