Diskussionen zu beliebigen Themen, die einen Bezug zu Neo, anderen Tastaturlayouts oder Tastaturen haben.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2.1 KiB

Neo-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