HxNeo-Monatstreffen Mai 2020

Retrospektive
– kurze Ergebnisbesprechung zum April: https://pads.ccc.de/ZuvLydEbSP


Themenliste

(1) Kommunikation per IRC? Oder eher was „modernes“ wie Matrix/XMPP (ggf. darauf basierend)?
  (vorgeschlagen von hrnz)
 * Beiträge der ML automatisch von einem Bot im IRC posten lassen
   * hrnz macht das
 * Issues im Gitea genauso
 * Git issues als frage/vorschlag platform
   * Tags und Farben festlegen
   * Template mit:
     * [ ] ich habe in der FAQ nichts zu meinem Problem gefunden
     * [ ] Mein OS ist X in Version Y, Mapping ist über $Tool, $Windowmanager
       * Gleich überführen in Tags wie "Linux" + "Gnome" z.B.
     * [ ] Nix von dem oben genannten ist relevant, sondern allgemeiner Natur
 * Hinweisbutton, um auf Gitea ein neues Issue anzulegen → qwertfisch

(2) Zugriffsrechte auf Serverlandschaft (aber ggf. auch Supportpflichten)
  (vorgeschlagen von qwertfisch)
 * mbuhl verpflichtet sich
 * imp freiwilligt sich
 * Serverlandschaft dokumentieren (eigenes repo)


(3) Dokumentation
 * Kein klassisches Wiki, sondern Doku auf statischen Seiten
 * im Git versionieren
 * Markdown bevorzugt
 * Suchfunktion
 * unkompliziertes Theming

Vorschlag: MkDocs (gibt’s auch mit Sphinx-Theme und allem pipapo, aber ist von vornherein auf Markdown ausgelegt)
 * ja zu MkDocs
 * ja zum ReadTheDocs-Theme (Sphinx-Theme)


(4) Dokumentation entrümpeln
 * kann im selben Zug gemacht werden, wie der Umzug zum neuen Dokusystem
 * Inhaltliche Struktur neu fassen (Sections, ggf. Subsections, einzelne Pages)
 * gute inhalte aus dem alten Wiki kirschenpflücken.
 * blickfang und kurzübersicht landing page in hübsch und bunt und mit farbe, leichtes navigieren in doku und zurück zur seite
 * struktur + layout Besprechung am 17.5; bis dahin Vorschläge vorbereiten


(5) Zugriffsrechte für neue Doku
 * eigentlich alle, geht dann über Fork/PR. Oder halt direkt, wenn man lieb fragt.
 * wie aktuell mit Git auch
 * erschwert kollaboratives Arbeiten an derselben Seite?


Für weitere Dinge offen!

Continuous Integration mit gitea
Docs githook