GitHub-Wikis sind ein Anti-Pattern

The GitHub wiki is an anti-pattern

Michael Heap argumentiert, dass das GitHub-Wiki ein Anti-Pattern ist. Der einzige Vorteil: Es ist immer da. Dagegen sprechen viele Gründe: Dokumentation im /docs-Ordner wird mit dem Code versioniert, ist lokal beim Klonen verfügbar, durchläuft Pull-Request-Reviews, kann mit GitHub Actions gelintet werden und erlaubt vertraute Tools. Wikis bieten kaum Branding und keinen Bild-Upload. Sein Rat: Docs im /docs-Ordner pflegen, per GitHub Pages veröffentlichen und eine Wiki-Seite als Weiterleitung nutzen.