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