2.1 KiB

Raw Permalink Blame History

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