Zum Inhalt springen

Anwendungsfall · Entwicklung

Die Karte erinnert sich an das Gespräch, aus dem sie kam

Enclessa hält Entwicklungsarbeit und die Diskussion darüber in einem Produkt: GitHub-Issues und Pull Requests werden auf Boards synchronisiert, der zusammengefasste Check-Status und die Review-Entscheidung erscheinen auf der Karte, und jede Karte trägt einen Link zurück auf Kanal und Nachricht, aus denen die Arbeit entstanden ist. Boards gehören zu einem Team und übernehmen dessen Rollen, sodass kein zweites Berechtigungsmodell zu verwalten ist; API, Webhooks und Slash-Befehle decken die Werkzeuge ab, die der Connector nicht abdeckt.

Aktualisiert

Maßgebliche Quelle
GitHub für den Code, Enclessa für die Arbeit und das Gespräch
Synchronisierung
Issues und Pull Requests, in beide Richtungen, wenn aktiviert
Auf der Karte
Check-Status, Review-Entscheidung, der verknüpfte Pull Request
Herkunft
Eine Karte verweist auf die Nachricht, aus der sie kam
Berechtigungen
Boards übernehmen die Rollen des Teams
Voraussetzung
Die Module Aufgabenboards und GitHub — der Team-Tarif

Die Ausgangslage

Ein Team liefert Software aus. Der Code liegt in GitHub, die Planung in einem Projektwerkzeug, das Gespräch in einem Chat-Produkt, und die Beziehung zwischen den dreien existiert nur in den Köpfen derer, die dabei waren. Jede Frage der Art „Warum ist das so?“ wird damit beantwortet, dass sich jemand erinnert — oder eben nicht.

Was schiefgeht, wenn das über vier Produkte verteilt ist

  • Entscheidung und Ticket liegen in verschiedenen Produkten

    Der Grund für eine Aufgabe war ein Gespräch. Die Aufgabe ist ein Titel und zwei Zeilen, die hinterher geschrieben wurden. Wer sie später übernimmt, bekommt die zwei Zeilen.

  • Das Board ist eine zweite, schlechtere Kopie des Repositorys

    Issues werden als Karten dupliziert und dann doppelt gepflegt, was etwa drei Wochen hält. Danach ist das Board Dekoration, und das Standup vergeht mit der Frage, was eigentlich gerade passiert.

  • Ein zweites Berechtigungsmodell, das synchron bleiben muss

    Das Projektwerkzeug hat eine eigene Vorstellung davon, wer in welchem Projekt ist, die sich stetig davon entfernt, wer in welchem Team ist — und niemand prüft das.

  • Um den Build zu prüfen, muss man woandershin

    Ob der Pull Request zu dieser Arbeit grün ist, lässt sich nur in einem anderen Tab beantworten — also wird es seltener gefragt, als es sollte.

Wie Enclessa damit umgeht

  1. Team, Kanäle und Board an einen Ort bringen

    Ein Board gehört zu einem Team und nutzt dessen Rollen. Wer den Kanal sehen kann, sieht also auch die Arbeit. Es gibt keine separate Projektmitgliedschaft zu pflegen und keine Möglichkeit, dass beide auseinanderlaufen.

  2. Das Repository einmal auf Ebene der Organisation verbinden

    Ein Administrator richtet eine Verbindung mit einer GitHub App oder einem persönlichen Zugriffstoken ein; sie gilt für GitHub.com oder GitHub Enterprise Server. Wer Boards verwalten darf, verknüpft dann ein bestimmtes Board mit einem Repository, einem Projects-v2-Projekt oder beidem.

  3. Die Spalten dem Projektstatus zuordnen

    Board-Spalten werden dem Status-Feld eines GitHub-Projects-v2-Projekts zugeordnet. Eine Karte zu verschieben und ein Projekteintrag zu verschieben bedeutet dann dasselbe — statt zweier Dinge, die abgeglichen werden müssen.

  4. Pull Requests an die Arbeit hängen, die sie abschließen

    Ein Pull Request, der ein Issue schließt, hängt sich an die Karte dieses Issues, statt eine zweite Karte zu werden, und die Karte zeigt Check-Status und Review-Entscheidung. Ob die Arbeit fertig ist, sieht man auf dem Board.

  5. Bewusst entscheiden, ob Enclessa zurückschreiben darf

    Das Zurückschreiben nach GitHub ist eine Einstellung je Organisation. Bleibt sie aus, liest der Connector nur; ist sie an, verschiebt das Verschieben einer Karte den Projekteintrag. So oder so hat jemand das entschieden, statt von einer Voreinstellung überrascht zu werden.

  6. Arbeit aus dem Gespräch anlegen, das sie hervorgebracht hat

    Wird aus einer Diskussion in einem Kanal Arbeit, legen Sie die Karte aus der Nachricht an. Der Rückverweis bleibt erhalten, sodass die nächste Person, die die Karte liest, die Argumentation dahinter nachlesen kann — und eine Karte lässt sich von hier aus als neues GitHub-Issue anlegen.

Welcher Tarif dafür nötig ist

Aufgabenboards und der GitHub-Connector gibt es beide ab dem Team-Tarif, und GitHub setzt Aufgabenboards voraus, weil das, was es synchronisiert, Board-Karten sind. Webhooks, Slash-Befehle, Bot-Konten und API-Token gibt es in denselben Tarifen. Kanäle und Threads funktionieren in jedem Tarif.

Tarife vergleichen

Was das nicht leistet

Hier gesagt, statt nach der Anmeldung entdeckt.

  • Nur GitHub. Es gibt keinen Connector für GitLab, Bitbucket, Azure DevOps oder Jira, und keiner ist so geplant, dass man sich darauf verlassen könnte.
  • Enclessa hostet keinen Code, führt keine Pipelines aus und prüft keine Diffs. Es zeigt den Stand von Arbeit, die in GitHub liegt.
  • Boards haben keine Abhängigkeiten, Unteraufgaben, Automatisierungsregeln, boardübergreifenden Ansichten oder Auswertungsdiagramme. Das fehlt bewusst und wird auch fehlen.
  • Es gibt keinen Ereignisstrom aus der Plattform hinaus. Werkzeuge, die auf etwas in Enclessa reagieren wollen, müssen danach abfragen.
  • Aufgabenboards sind ein Modul, ausgeschaltet, bis ein Betreiber es einschaltet. Sind Boards aus, antwortet jede GitHub-Route mit 404, statt halb zu funktionieren.

Fragen

Entwicklungsarbeit an einem Ort: häufige Fragen

  • Nein. Code, Pull Requests und Pipelines bleiben in GitHub. Enclessa synchronisiert Issues und Pull Requests auf ein Board, zeigt Check-Status und Review-Entscheidung auf der Karte und hält das Gespräch über die Arbeit im selben Produkt.
  • Ja. Eine Board-Karte trägt einen Link auf Kanal und Nachricht, aus denen die Arbeit entstanden ist — genau das, was ein separates Projektwerkzeug nicht kann.
  • Nein. Ein Board gehört zu einem Team und übernimmt dessen Rollen. Wer den Kanal sehen kann, sieht also auch die Arbeit, und es gibt kein zweites Berechtigungsmodell, das synchron gehalten werden muss.
  • Nur, wenn die Organisation das Zurückschreiben eingeschaltet hat. Das ist eine bewusste Einstellung je Organisation; ist sie aus, liest der Connector von GitHub und schreibt nie dorthin.

Verschlüsselte Zusammenarbeit, gehostet in Europa.

Legen Sie in ein paar Minuten einen Workspace an. Er gehört Ihnen, erreichbar unter your-team.enclessa.app, betrieben in der Europäischen Union, mit Ende-zu-Ende-verschlüsselten Direktnachrichten ab der ersten.