Und Gott sprach: Es werde eine Ausdehnung inmitten der Wasser, und sie scheide die Wasser von den Wassern! Und Gott machte die Ausdehnung und schied die Wasser, welche unterhalb der Ausdehnung, von den Wassern, die oberhalb der Ausdehnung sind. Und es ward also. Und Gott nannte die Ausdehnung Himmel. Und es ward Abend und es ward Morgen: zweiter Tag.

Pointillismus. Jeder der sich noch an den Kunstunterricht erinnern kann weiß, dass Künstler sich hier mit kleinen Farbpunkten zum Ausdruck bringen. Formen und Dinge werden nicht direkt auf die Leinwand gebracht, sondern ein Meer aus Punkten geschaffen, die ich der Betrachter erst zu einem Gemälde zusammenfassen muss.

Ein Beispiel ist die sommerliche Szene im Park am Anfang des Textes. Abertausende von Farbpunkten formen Menschen, Tieren und den Park an sich. Gehe ich näher heran verschwinden alle diese Formen und ich sehe nur eine Unzahl an Punkten.

Und so ist es auch mit meiner Wahrnehmung. Alles das, was ich sehe, höre, rieche, oder taste sind Abermillionen kleine Punkte die mir ein Signal von der Welt liefern. Sie sind das unbekannte Chaos, was bei zu naher Betrachtung nicht sehr viel Sinn ergibt. Also macht mein Geist einen Schritt zurück und fasst alles zu einfacheren, materiellen Formen zusammen.

Dabei stehen sie aber nicht für sich alleine. Gleichzeitig ist es auch kein undifferenziertes großes Ganzes. Meine Welt wandert eher zwischen den Zuständen hin und her. Ich sehe den gesamten Park, dann fokussiere ich mich auf die Frau rechts im Bild, mit ihrem Schirm, Hut und einem Affen an der Leine.

Worauf will ich hinaus? Wenn die Finsternis gelichtet wird und ich die ersten Erfahrungen eines unbekannten Teils der Welt mache, erkenne ich welche Dinge sich darin befinden. Ich hebe das Erkannte aus dem Chaos, verbinde die einzelnen Details und nehme die gesamte Szene wahr.

Dieses Netz ist es das einen Himmel aufspannt, indem sich meine Gedanken frei bewegen können. Somit habe ich jetzt auch wieder den Bogen zurück zur eigentlichen Geschichte geschlagen. Es sind meine Gedanken die wie Vögel über die erkannten Dinge fliegen und sie zu einem komplizierten Muster verbinden. Die Szene im Park erinnert mich zum Beispiel an Sommertage an der Hamburger Außenalster. In meinem Geist springt der Gedanken von einem zum anderen.

Jede neue Erkenntnis, jeder Sprung der Gedanken, schafft aber nicht nur Neues, sondern ändert auch das Wissen, das ich längst besitze. Meine Gedanken formulieren alte Wahrheiten kontinuierlich um, passen sie an und halten sie so am Leben. Und so entsteht ein sich ständig änderndes Netzwerk aus Ideen, Erinnerungen und Erkenntnissen das die Landkarte meines Ichs definiert.

Es schafft meine erlebte Welt und so lange es im Kontakt mit der Welt bleibt sind beide im Einklang. Aber was ist, wenn ich einen Höhenflug habe? Was passiert, wenn meine Gedanken zu frei sind? Ich verliere den Kontakt, bin nicht mehr bodenständig, und schaffe Scheinwelten die jede sinnhafte Wahrheit über den Haufen werfen.

Jeder kennt diesen Zustand. Als Kind wünsche ich mir etwas, ein Spielzeug oder einen Ausflug, und gehe fest davon es zu bekommen. Ich male mir aus wie es sein wird und was ich alles mache werde. Ich schaffe ganze Welten, nur um manchmal von der Realität enttäuscht zu werden. Schlimmer ist es, wenn diese Scheinwelt in unser aller Welt überschwappt. Im letzten Jahrhundert sind wir alle kollektiv in eine Wahnwelt, ungehindert von Realität und Wahrheit getreten und jeder hat dafür einen hohen Preis bezahlt.

Es sind aber auch diese Höhenflüge, durch die ich Neues wage, kreativ bin und in die Finsternis vorstoßen. Es ist das Versprechen nach etwas Besserem das mich verleitet an meine Grenzen zu gehen und vielleicht darüber hinaus. Das bedeutet, ohne sie erweitere ich nicht meinen Horizont, stagniere und sehe irgendwann die Welt an mir vorbeiziehen. Fliege ich hingegen zu hoch, lasse das Bekannte zurück und baue Luftschlösser, bricht diese Welt auf kurz oder lang über mir zusammen.

Somit finde ich eine Balance zwischen meinen progressiven und konservativen Kräften. Keine darf dominieren für das Wohl des Ganzen. Die eine entdeckt neues Wissen, während die andere es bewahrt.

Nachwort

Ich spreche hier schon von Wissen und wie es aus dem Unbekannten gehoben wird. Das greift den dritten Tag vorweg, war aber notwendig, um das Entstehen von Gedanken zu beschreiben. Ich denke, dass eine passiert eh zusammen mit dem anderen. Das Format einer linearen Geschichte erlaubt nur leider nicht Gleichzeitigkeit darzustellen. Es ist somit auch einer erster Beweis für die Verzahnung der Geschichten in der Bibel. Spätere Geschichten haben ein Echo in früheren und umgekehrt.

Referenzen

• Voriger Post: Tag 1: Die Schaffung der eigenen Welt
• Zurück zur Übersicht

Im Anfang schuf Gott die Himmel und die Erde. Und die Erde war wüst und leer, und Finsternis war über der Tiefe; und der Geist Gottes schwebte über den Wassern. Und Gott sprach: Es werde Licht! und es ward Licht. Und Gott sah das Licht, daß es gut war; und Gott schied das Licht von der Finsternis. Und Gott nannte das Licht Tag, und die Finsternis nannte er Nacht. Und es ward Abend und es ward Morgen: erster Tag.

Was sind die Grundbausteine meiner Welt? In der Schule lernen wir, dass sie aus Atomen, Molekülen und anderen Elementarteilchen besteht, aber nichts davon kann ich sehe, riechen, oder fühlen. Womit ich jedoch jeden Tag konfrontiert werde, ist das Bekannte und das Unbekannte. Daraus baue ich meine Welt auf.

Ich kenne meine Heimat, meine Familie und Freunde sowie die vielen Dinge meines Alltags. Der Rest besteht aus allen den Dingen, die mir fremd sind. Wie fliegt man ein Flugzeug oder besteigt einen hohen Berg? Davon weiß ich nichts. Aber völlig unbekannt sind sie mir auch nicht. Ich muss irgendeine Art von Wissen vom Fliegen oder Bergsteigen haben, um sagen zu können “Ich verstehe es nicht” und wenn es nur das Wort ist.

Was mache ich aber mit den Dingen, von denen ich noch nicht einmal weiß, dass ich sie nicht weiß? Sie sind weniger als unbekannt. Sie existieren für mich nicht. Ich bin nicht in der Lage ein einzelnes Wort, Bild, oder Gefühl für sie zu artikulieren.

Meine Welt besteht somit nicht nur aus dem Bekanntem und Unbekanntem, sie ist auch umgeben von dem, was für mich nicht existiert.

Was hat das Ganze jetzt aber mit der Bibel und der Schaffung der Welt zu tun? Das ist der Bogen, den ich versuche zu schlagen und ich glaube, die Symbole Finsternis, Wasser und Erde spiegeln genau diese Grundbausteine meiner wahrgenommenen Welt wider.

Wenn ich sehe, fühle, rieche, höre, schmecke, in kurz, erfahre, wird mein Geist mit Licht und Farbe geflutet. Jetzt ist die Welt da draußen aber so groß und detailliert, dass mich nur der kleinste Teil von ihr erreicht. Der Rest ist abwesend. Er ist in Finsternis gehüllt. Das ist der Teil, von dem ich noch nicht einmal weiß, dass ich ihn nicht kenne. Ein Beispiel: Selbst so augenscheinlich simple Dinge wie eine Blume geben sich nie vollständig preis.

Was ich sehe, ist die rote Blüte und die grünen Blätter, die Formen und einzelnen Details. Aber was ist mit den Zellen? Mit den Molekülen, Atomen, und was auch immer darunter liegt? Alle die Feinheiten und Dynamik gehen an mir verloren. Ich sehe nur ein simples Ding.

Wenn ich meine Aufmerksamkeit aber auf einen Teil diese Finsternis richte, mir ein Mikroskop nehme und das Blatt darunter beobachte, wird sie verband und an ihre Stelle treten unzählige neue Eindrücke. Ich entdecke eine Welt voll Dynamik, Komplexität, Form und Muster. Ich verstehe ein wenig mehr, aber erkenne gleichzeitig, was ich noch nicht weiß. Das nicht Existente wird zum Unbekanntem reduziert.¹

Finsternis ist somit das, was ich nie wahrgenommen habe. Es ist das Symbol für das, was für mich nicht existiert. Erst der Akt des Nachschauens lässt mich das Unbekannte entdecken. Es bringt diese Erfahrungen in meinen Geist. Bringt Licht in das Dunkel.

Wasser wiederum ist das ideale Symbol für dieses Unbekannte. Es ist materiell, hat Struktur, aber keine Permanenz. Alles, was ich erkenne, verschwindet im nächsten Augenblick wieder und somit kann ich es nie voll greifen oder verstehen.²

Das wird nur möglich durch Stabilität. Die Erde als fester Grund scheint mir genau das Symbol dafür zu sein. Sie hat Struktur, die bleibt und ist vorhersagbar. Mit anderen Worten, sie ist Ordnung. Erde ist das, was ich verstehe und kenne.

Woher aber kommt sie? Bin ich es, der die Ordnung schafft? Ich glaube nicht. Wäre die Welt da draußen nicht inhärent voll mit Mustern und Stabilität könnte ich keine Struktur erkennen. Was sich nicht vorhersagen lässt, ändert diese Eigenschaft auch nicht, egal wie lange ich darauf starre. Vielmehr ist es das Chaos aus dem nicht Existentem (Finsternis) und dem Unbekanntem (Wasser), dass reif mit Struktur ist, die noch erkannt werden will. Das ist es, was mein Geist tut, wenn er sich dem Chaos stellt. Für einen kurzen Moment trennt er die Union.

Aber keine zwei Personen sehen dieselbe Welt. Jede ist subjektiv. Was für mich noch Chaos ist, ist vielleicht für eine andere bereits Ordnung. Somit ist Chaos die Abwesenheit von eigener Ordnung. Es ist das, was außerhalb meines Geistes liegt.

Die Schaffung meiner erlebten Welt ist somit auch gleich die Schaffung der Welt im gesamten. Wenn zwei Personen in Beziehung stehen, teilen sie das Subjektive. Ihre Welten interferieren, passen sich an und werden zu einer. Und so verschmelzt das gesamte Netzwerk aus Beziehung alle unsere Welten und schafft einen physischen, sozialen, psychologischen, rationalen, kreativen, in kurz, rein menschlichen Kosmos. Was er aber nicht ist, ist die Welt an sich. Ich weiß nicht, was die echte Realität ist, noch werde ich es je wissen. Ich sehe nur ihr Licht durch alle unsere Augen.

Als nächstes in der Serie: Tag 2: Die Gedanken sind frei

Nachwort

Es ist mein Geist, der in die Finsternis vordringt und einen Teil der Welt wahrnimmt. Dadurch wird das Unbekannte freigelegt und somit schwebt er über der Tiefe des Wassers. Noch habe ich keine Permanenz erkannt und somit bleibt meine Welt wüst. Erst die nächsten Tage werden das Bekannte aus diesem Meer heben.

Wenn ich am Anfang einer der Geschichten stehe, frage ich mich manchmal, wie viel schon in so wenig Text enthalten sein kann. Wie viel Wissen kann man in wenige Sätze komprimieren? Und immer wieder bin ich von den vielen Seiten voller Notizen überrascht. Mein Verstand, jeder Verstand, ist gefüllt mit Eindrücken und Erkenntnissen und diese Geschichten scheinen ein Schlüssel zu sein, sie alle freizulegen.

Referenzen

• Zurück zur Übersicht

Schon immer habe ich aber auch eine Abneigung gegenüber willkürlicher Autorität. Religion und ihre Institution Kirche waren da für mich das Paradebeispiel. Starre Regeln, alte Strukturen und Gott der die ultimative Form der absolut unbändigen Autorität ist. Mit anderen Worten, der Kontakt mit Religion hat mich zum Atheisten werden lassen. Erst unbewusst, dann aber mehr und mehr ausgesprochen.

Mit meinem Erwachsenwerden, dem Verlassen der Schule und Heimat endete aber auch jede Auseinandersetzung mit dem Thema. Ich ließ es hinter mir zusammen mit vielen anderen Dingen der Jugend. Jahre später sitze ich aber auf einmal hier und lese die Bibel. Noch mehr, ich schreibe über sie. Warum?

Der Sprung aus der Jugend in ein eigenes Leben ist aufregend, befreiend, aber auch schwer. Alle die kleinen und großen Probleme des Alltags sind jetzt die eigenen. Keine Familie oder Schule mehr die vieles abfängt.

Und dann sind da noch die großen Fragen wie “Was ist das Ziel?” oder “Wie gehe ich mit eignen oder dem Tod von anderen um?”. In der Schule und Uni war ich “unsterblich”. Der Tod war kein Ding, das Leben geht immer weiter, und der Sinn lag im Bestehen der nächsten Prüfung und darin Spaß zu haben. Jetzt, mit einer eigenen Familie und keinen einfachen Zielen mehr, wie das Sammeln von Noten, was ist die Antwort? Unsterblich bin ich schon lange nicht mehr.

Irgendwie hatten mich diese Fragen immer wieder zu alten Texten und Büchern geführt, und immer wieder kam ich in Kontakt mit den Geschichten in der Bibel.

Es sind Geschichten, die vielleicht so alt sind wie wir Menschen selbst. Geschichten, die wir mühsam am Leben erhalten und weitertragen schon so lange wie Menschen gedenken. Generation um Generation hat seine eigenen Ansichten und Ideen eingearbeitet, bis dieses Destillat entstand. Aber Destillat wovon?

Ist es ein Werk der Philosophie? Der Theologie oder Psychologie? Vielleicht der Sozialkunde, Geschichte, Poesie oder Literatur? Es trägt Aspekte von alledem und noch vielem mehr und doch scheinen sie alle auf eine Frage ausgerichtet zu sein: Was heißt es Mensch zu sein? Diese Frage ist es die alle die Hürden des Alltags aber auch die großen Fragen in sich vereint. Die Antworten darauf sind komplex und immer persönlich.

Das bedeutet aber auch, dass die Geschichten keine einfachen Rezepte für den blinden Konsum sind. Eine wortwörtliche Auslegung führt einen eher in die Irre. Es ist eine Abstraktion voll mit Symbolen. Ein Konzentrat von tausenden von Jahren menschlicher Erfahrung. Es zu nehmen wie geschrieben heißt die unzähligen Details aber auch das größere Ganze zu ignorieren. Dann bleibt es, wie damals in der Schule, ein langatmiges Buch, dass in der hintersten Ecke verstaubt.

Interpretation ist was die Erkenntnisse alle dieser Generationen freilegt und mit dem eigenen Leben verbindet. Die Reise durch die Geschichten ist somit auch eine Reflexion des eigenen Geistes. Am Ende wird es ein Mischung aus beidem sein.

Diese Textserie ist meine persönliche Reflexion in den Geschichten der Bibel.

Meine Ziele

Eine persönliche Interpretation zu schaffen, Leitmotive zu finden, und daraus hilfreiche Prinzipien für den Alltag abzuleiten. Es soll zudem eine Übung sein, um meinen Geist zu trainieren. So wie Sport den Körper stärkt und gesund hält, braucht der mein Geist Stärkung. Er braucht eine Herausforderung, an der er sich messen und wachsen kann.

Mein Vorgehen

Ich setze mir selber ein paar Spielregeln im Umgang mit der Bibel:

1. Wenn Erzählungen in der Bibel mit wissenschaftlichen Erkenntnissen in Konflikt stehen gewinnt die Wissenschaft. Immer. Die Menschheit ist nicht aus Adam und Eva hervorgegangen. Die Erde ist nicht nur ein paar tausend Jahre alt. Evolution ist ein Ding. Kurzum, die Bibel ist gefüllt mit Symbolen nicht wissenschaftlichen Erkenntnisse.
2. Die Symbolik existiert nicht nur in den Texten, sondern auch in der Kunst oder Architektur. Europäische und Deutsche Kultur wurde so lange vom Christentum geprägt, dass wir überall Symbole und Interpretationsoberflächen finden. Deshalb versuche ich auch diese Aspekte einzuarbeiten.
3. Die Definition für Gott, die ich habe, führt mich direkt zum Atheismus was hier erstmal nicht zuträglich ist. Deshalb werde ich vorerst Gott nicht erwähnen, nicht in seiner personifizierten Form wie er vor allem im Alten Testament oder den Kirchen beschrieben wird. Mir ist schlussendlich nicht klar was das Wort bedeutet.
4. Ich verwende die Elberfelder Übersetzung in verschiedenen Versionen. Warum? Sie ist eine der wortgetreueren Übersetzungen aus dem hebräischem oder griechischem und hält je nach Version viele Hinweise auf alternative Wortbedeutungen. Das vergrößert die Interprationsfläche im Gegensatz zu anderen Übersetzungen die vereinfachen oder modernisieren.

Die Schaffung der Welt. Was bleibt von der ersten Geschichte, wenn ich die einfachste aller Interpretationen, die Geburt unserer physischen Welt durch einen Gott, außen vor lasse? Wie lassen sich die Symbole noch verstehen? Das ist die Frage, die ich in den folgenden Posts versuche zu beantworten.

Im Anfang schuf Gott die Himmel und die Erde. Und die Erde war wüst und leer, und Finsternis war über der Tiefe; und der Geist Gottes schwebte über den Wassern. Und Gott sprach: Es werde Licht! und es ward Licht. Und Gott sah das Licht, daß es gut war; und Gott schied das Licht von der Finsternis. Und Gott nannte das Licht Tag, und die Finsternis nannte er Nacht. Und es ward Abend und es ward Morgen: erster Tag.

Moses 1: Tag 1: Die Schaffung der eigenen Welt

Und Gott sprach: Es werde eine Ausdehnung inmitten der Wasser, und sie scheide die Wasser von den Wassern! Und Gott machte die Ausdehnung und schied die Wasser, welche unterhalb der Ausdehnung, von den Wassern, die oberhalb der Ausdehnung sind. Und es ward also. Und Gott nannte die Ausdehnung Himmel. Und es ward Abend und es ward Morgen: zweiter Tag.

Moses 1: Tag 2: Die Gedanken fliegen frei

Und Gott sprach: Es sammeln sich die Wasser unterhalb des Himmels an einen Ort, und es werde sichtbar das Trockene! Und es ward also. Und Gott nannte das Trockene Erde, und die Sammlung der Wasser nannte er Meere. Und Gott sah, daß es gut war. Und Gott sprach: Die Erde lasse Gras hervorsprossen, Kraut, das Samen hervorbringe, Fruchtbäume, die Frucht tragen nach ihrer Art, in welcher ihr Same sei auf der Erde! Und es ward also. Und die Erde brachte Gras hervor, Kraut, das Samen hervorbringt nach seiner Art, und Bäume, die Frucht tragen, in welcher ihr Same ist nach ihrer Art. Und Gott sah, daß es gut war. Und es ward Abend und es ward Morgen: dritter Tag.

Und Gott sprach: Es werden Lichter an der Ausdehnung des Himmels, um den Tag von der Nacht zu scheiden, und sie seien zu Zeichen und zur Bestimmung von Zeiten und Tagen und Jahren; und sie seien zu Lichtern an der Ausdehnung des Himmels, um auf die Erde zu leuchten! Und es ward also. Und Gott machte die zwei großen Lichter: das große Licht zur Beherrschung des Tages, und das kleine Licht zur Beherrschung der Nacht, und die Sterne. Und Gott setzte sie an die Ausdehnung des Himmels, um auf die Erde zu leuchten, und um zu herrschen am Tage und in der Nacht und das Licht von der Finsternis zu scheiden. Und Gott sah, daß es gut war. Und es ward Abend und es ward Morgen: vierter Tag.

Und Gott sprach: Es wimmeln die Wasser vom Gewimmel lebendiger Wesen, und Gevögel fliege über der Erde angesichts der Ausdehnung des Himmels! Und Gott schuf die großen Seeungeheuer und jedes sich regende, lebendige Wesen, wovon die Wasser wimmeln, nach ihrer Art, und alles geflügelte Gevögel nach seiner Art. Und Gott sah, daß es gut war. Und Gott segnete sie und sprach: Seid fruchtbar und mehret euch und füllet die Wasser in den Meeren, und das Gevögel mehre sich auf der Erde! Und es ward Abend und es ward Morgen: fünfter Tag.

Und Gott sprach: Die Erde bringe hervor lebendige Wesen nach ihrer Art: Vieh und Gewürm und Getier der Erde nach seiner Art! Und es ward also. Und Gott machte das Getier der Erde nach seiner Art, und das Vieh nach seiner Art, und alles, was sich auf dem Erdboden regt, nach seiner Art. Und Gott sah, daß es gut war. Und Gott sprach: Lasset uns Menschen machen in unserem Bilde, nach unserem Gleichnis; und sie sollen herrschen über die Fische des Meeres und über das Gevögel des Himmels und über das Vieh und über die ganze Erde und über alles Gewürm, das sich auf der Erde regt! Und Gott schuf den Menschen in seinem Bilde, im Bilde Gottes schuf er ihn; Mann und Weib schuf er sie. Und Gott segnete sie, und Gott sprach zu ihnen: Seid fruchtbar und mehret euch und füllet die Erde und machet sie euch untertan; und herrschet über die Fische des Meeres und über das Gevögel des Himmels und über alles Getier, das sich auf der Erde regt! Und Gott sprach: Siehe, ich habe euch gegeben alles samenbringende Kraut, das auf der Fläche der ganzen Erde ist, und jeden Baum, an welchem samenbringende Baumfrucht ist: es soll euch zur Speise sein; und allem Getier der Erde und allem Gevögel des Himmels und allem, was sich auf der Erde regt, in welchem eine lebendige Seele ist, habe ich alles grüne Kraut zur Speise gegeben. Und es ward also. Und Gott sah alles, was er gemacht hatte, und siehe, es war sehr gut. Und es ward Abend und es ward Morgen: der sechste Tag.

Übrigens ist hier ein Link zu der digitalen CSV Version, mit einer Fülle an alternativen Übersetzungen.

Referenzen

• Zurück zur Gesamt-Übersicht
• Zitat: Bibel-Online.net
• Detailierte Übersetzung: 1. Mose 1 :: Elberfelder Bibelübersetzung Edition CSV

But eventually, it culminates in something tangible. The What and How become clearer and now I sit there with a bunch of untested code. The only way that I can know that it works is by manually testing it. Every. Time. This is the real drag now.

Our MVP example

Okay, but how would we go about it? First, let’s add a small example. We build a prototype of a movie database. Think IMDB minus all the features. After some back and forth the first MVP looks like this:

It won’t win a design award but it works. Under the hood, it is a basic React app (code here) talking to a Golang backend (code here). Of course, you can substitute that tech stack with whatever you want. What we will talk about in the following isn’t tied to a language or framework.

Now I could go in and add a whole bunch of unit and integration tests but at the same time, this MVP just shipped. People seem to use it (don’t ask me why). We have to fix bugs, add features, and grow the product before we run out of time, money, or both.

So, as it happens, we have to find another, less time-consuming path. Instead of focusing on each class and function why not look at it from a higher level? What happens when we test from the perspective of a user? I mean, at this moment, we are doing that anyway. Manually testing, or acting like a user, is the only tool that we have. So why not make that an automated process to speed up things?

A simple user interaction test

What is it a user would see when they open our app?

test("Case: User opens the app and sees multiple movies", async () => {
  await render(
    <MemoryRouter initialEntries={['/']}>
      <App  fetch={ mockFetch } />,
    </MemoryRouter>
  );

  expect(screen.getByText(/Harry Potter and the Sorcerer's Stone/i)).toBeInTheDocument();
  expect(screen.getByText(/Harry Potter and the Chamber of Secrets/i)).toBeInTheDocument();
  expect(screen.getByText(/Create Movie/i)).toBeInTheDocument();
}

Now, we could mock all requests via mockFetch but we would need to write additional, independent tests for the backend too. The appeal of manual end-to-end tests is that we know that the whole thing works when we are done testing. So instead of having separate sets of data, we put it all into a central file shared between the frontend and the backend.

name: User opens the app and sees multiple movies
view: /
app:
  textShouldExist:
    - Harry Potter and the Sorcerer's Stone
    - Harry Potter and the Chamber of Secrets
callChain:
  - request:
      uri: /api/movie/all
      method: GET
      headers:
    response:
      type: success
      status: 200
      body:
        - id: "0"
          title: "Harry Potter and the Sorcerer's Stone"
          releaseYear: 2001
        - id: "1"
          title: "Harry Potter and the Chamber of Secrets"
          releaseYear: 2002

That is our contract between both systems and the representation of a user interaction.

Our test code becomes:

test("Case: User opens the app and sees multiple movies", async () => {
  // helper function to load contracts from disk
  const contract = loadContract('home/no_movies_found.yaml');
  const mockFetch = new MockFetch(contract.callChain);

  await render(
    <MemoryRouter initialEntries={['/']}>
      <App  fetch={ mockFetch } />,
    </MemoryRouter>
  );

  app.textShouldExist.forEach((text, _) => {
    expect(screen.getByText(text)).toBeInTheDocument()
  });
  expect(screen.getByText(/Create Movie/i)).toBeInTheDocument();
}

To not repeat ourselves all the time I will extract all that contract loading and rendering into a separate function called runContract. Now we end up with the following:

runContract("home/multiple_movies_found.yaml", (app, _) => {
  expect(screen.getByText(/Create Movie/i)).toBeInTheDocument()

  app.textShouldExist.forEach((text, _) => {
    expect(screen.getByText(text)).toBeInTheDocument()
  });
});

Let’s take the same YAML and try to test the backend with it. We have a chain of request and response pairs. What we can do is simply run all requests through our business logic and see if it produces the expected outcome.

func Test_CDC_HomeMultipleMoviesFound(t *testing.T) {
  contract := MustLoadCDC(cdcPath)

  t.Logf("Case: %s", contract.Name)

  movieServiceMock := &mockMovieService{movies: ???}

  for _, requestAndResponse := range contract.CallChain {
    request := httptest.NewRequest(
      requestAndResponse.Request.Method,
      requestAndResponse.Request.Uri,
      cdcutil.createBodyReader(requestAndResponse),
    )

    cdcutil.setHeaders(request, requestAndResponse)

    responseWriter := httptest.NewRecorder()

    ctx := listmovies.Context{Movies: movieServiceMock}
    ctx.Handle(w, r)

    response := responseWriter.Result()
    body, err := io.ReadAll(response.Body)
    assert.NoError(t, err)

    assert.Equal(t, requestAndResponse.Response.StatusCode, response.StatusCode)
    if requestAndResponse.Response.Type == "success" && requestAndResponse.Response.Body != nil {
      cdcutil.AssertEqualInterface(t, *requestAndResponse.Response.Body, body)
    } else if requestAndResponse.Response.Type == "error" {
      assert.Equal(
        t,
        requestAndResponse.Response.ErrorBody,
        string(body),
        "error body does not match"
      )
    }
  }
}

That is a mouthful. Let’s take it apart. After loading the contract file we create a mock for our movie database. Then we iterate through all the request and response pairs and evaluate if our code produces the same response as is stored in the YAML.

But wait. What do we put into the mock database? That is a piece of information we have to put into our contract too.

name: User opens the app and sees multiple movies
view: /
database:
  movies:
    - id: "0"
      title: "Harry Potter and the Sorcerer's Stone"
      releaseYear: 2001
    - id: "1"
      title: "Harry Potter and the Chamber of Secrets"
      releaseYear: 2002
app:
  textShouldExist:
    - Harry Potter and the Sorcerer's Stone
    - Harry Potter and the Chamber of Secrets
callChain:
  - request:
      uri: /api/movie/all
      method: GET
    ...

Now we can modify our test code like this:

func Test_CDC_HomeMultipleMoviesFound(t *testing.T) {
  contract := MustLoadCDC(cdcPath)

  t.Logf("Case: %s", contract.Name)

  movieServiceMock := &mockMovieService{movies: contract.Database.Movies}
  ...

And with a little cleaning up we get the following:

func Test_CDC_HomeMultipleMoviesFound(t *testing.T) {
  RunContracts(
    t,
    "/home/multiple_movies_found.yaml",
    func(r *http.Request, w http.ResponseWriter, movieService movie.MovieService) {
      ctx := listmovies.Context{Movies: movieService}

      ctx.Handle(w, r)
    }
  )
}

All that utility code was extracted into RunContracts.

That is it. Now we can simply add more YAML contracts and add those small test cases to the app and backend. Of course, you can also test different endpoints in a single contract or for example, make sure authentication is honored when doing certain operations. Those contracts do not become more complicated. Have a look at a bigger example here.

And has all that a name? Yes, Consumer Driven Contract (short: CDC) testing.

Legacy Systems

In my title, I also hinted at legacy systems. Sometimes we end up with that old piece of software. Nobody knows anymore how it works, there is no test coverage whatsoever, and to be frank the code is not in a shape that we can easily add unit tests. What can we do about it?

Writing a full test suite will take forever and getting that through might not be feasible. So what is the next best thing? Right, specify a bunch of interactions that you know the system needs to fulfill. Over time you can add all the edge cases you discover and through that grow your coverage. That is also one of the reasons why I like CDC testing for those scenarios. It neatly follows the Pareto principle. I get 80% of the return (test coverage) for 20% of the investment (engineering time) because I only define interaction contracts on a higher level and don’t tie my tests immediately to an implementation.

Books always accompany me, they enrich my life, and so I thought: Why not share some of their names so other people might enjoy them too? That is what this page is all about. It is a collection of titles in no particular order but with some rough classifications.

But more than that this page also holds a list of books I still want to read. In some sense my digital antilibrary.

Essentials

They are essential to me. They changed how I see the world and how I operate as a human being.

• A Treatise of Human Nature; David Hume, 1739
• Meditations; Marcus Aurelius, 161-180
• The Wealth of Nations; Adam Smith, 1776
• Crime and Punishment; Fyodor Dostoyevsky, 1866
• War and Peace; Leo Tolstoy, 1865
• Debt - The first 5000 years; David Graeber, 2011
• Bible
• How to read a book; Mortimer J. Adler, 1972

Well Rounded

Some I like. With some, I disagree. Some are a slug to read. But not having read them would have been a net negative.

• Trotzdem Ja zum Leben sagen (Man’s search for meaning); Viktor Frankl, 1946
• Siddharta; Hermann Hesse, 1922
• Brave new World; Aldous Huxley, 1931
• The Stranger; Albert Camus, 1942
• Republic; Plato, 375 BCE
• The Count of Monte Cristo; Alexandre Dumas, 1844
• The Brothers Karamazov; Fyodor Dostroyevsky, 1879
• The Idiot, Fyodor Dostroyevsky, 1868
• The Adventures of Huckleberry Finn; Mark Twain, 1884
• 1984; George Orwell, 1949
• Iliad; Homer, 8th century BC
• The Odyssey; Homer, 8th century BCE
• Mrs. Dalloway; Virgina Woolf, 1925
• Animal Farm; George Orwell, 1945
• Solaris; Stanislaw Lem, 1961
• The old man and the sea; Enerst Hemingway, 1952
• The Black Swan; Nassim Nicholas Taleb, 2007
• Consolations; David Whyte, 2014
• Histories; Herodotus, 340 BCE
• Romeo and Juliet; William Shakespear, 1597
• Hamlet; William Sharespear, 1599
• Die Verwandlung (The Metamorphosis); Franz Kafka, 1912
• In der Strafkolonie (In the Penal Colony); Franz Kafka, 1919
• Kabale und Liebe (Intrigue and Love); Friedrich Schiller, 1784
• Faust; Johann Wolfgang von Goethe, 1772
• The Futurological Congress; Stanislaw Lem, 1971
• An Anthropologiest on Mars; Oliver Sacks, 1995
• What’s our Problem? A Self-Help Book for Societies; Tim Urban, 2023

Just plain fun

Not every story changes how I see the world. Some just bring me joy. They carry me to a foreign place or let me have a break. They are a small vacation.

• The Lord of the Rings; J.R.R. Tolkien, 1954
  • The Fellowship of the Ring
  • The Two Towers
  • The Return of the King
• Foundation Cycle; Isaac Asimov
  • Foundation; 1951
  • Foundation and Empire; 1952
  • Second Foundation; 1953
• Pride and Prejudice; Jane Austen, 1813

Didn’t age well

While publicly celebrated I find their value questionable.

• Sapiens; Yuval Noah Harari, 2011
  • There is academic critique going around about this book (see here for an example).
• Thinking, Fast and Slow; Daniel Kahnemann, 2011
  • Some experimental results enumerated in his book are proven wrong by now. Besides that, I always compare his book to Hume’s Magnus Opus which isn’t particularly fair but still strikes me as astonishing that Hume uncovered many of the insights shared in Kahnemann’s book. But Hume did so already hundreds of years ago. So what I am left with is a book that stands on a shaky scientific foundation and provides me with insights that have been known for a long time.

Antilibrary

A list of my literary and academic blind spots. Books I haven’t read (yet). This list has only one goal: always be longer than all the lists above combined. My antilibrary should stay true to Aristotle’s exclamation ”The more you know, the more you realize you don’t know”.

Entries marked with 📕 are already in my collection.

• Lighthouse; Virginia Wolfe, 📕
• Trust; Hernan Diaz
• Wittgenstein’s Mistress; David Markson
• The Dawn of Everything; David Graeber, David Wengrow 📕
• Gödel, Escher, Bach: an Eternal Golden braid; Douglas R. Hofstadter
• Shogun; James Clavell
• East of Eden; John Steinbeck
• Dune; Frank Herbert
• Clear and Simple as the Truth: Writing Classic Prose; Noel, Turner
• The Hidden Life of Trees; Peter Wohlleben
• The Plague; Albert Camus, 1946, Robin Buss translation
• Der Traum vom Mond (The Dream); Johannes Kepler
• Jenseits von Gut und Böse; Friedrich Nietzsche
• On Anger; Seneca
• Das Kapital; Marx
• On the Origin of Species; Charles Darwin 📕
• The Categories; Aristotle, Revised Oxford Translation
• Leviathan; Thomas Hobbes
• A Thousand Brains; Jeff Hawkins
• The Extended Phenotype; Richard Dawkins
• The Selfish Gene; Richard Dawkins 📕
• Elements; Euclid, Heath translation
• The Pale King; David Foster Wallace
• The Picture of Dorian Grey; Oscar Wilde
• The Waste Land; T.S. Eliot
• The Natural House; Frank Lloyd Wright
• Tractatus Logico-Philosophicus; Ludwig Wittgenstein
• Principia Mathematica; Isaac Newton, 1686
• Phaedo; Plato
• Tao Te Ching; 4th century BCE
• Capitalism and Freedom; Milton Friedman, 1962
• The History of the Peloponnesian War; Thucydides, 5th century BCE
• City of God; St. Augustine, 5th century
• The Song of Roland; 11th century
• Niebelungenlied; 12th century
• The Prince; Niccolo Machiavelli, 1532
• Also sprach Zarathustra (Thus spoke Zarathustra); Friedrich Nietzsche, 1883
• Anna Katarina; Leo Tolstoy
• Farewell to Arms; Ernest Hemingway
• For Whom the Bell Tolls; Ernest Hemingway
• Notes from Underground; Fyodor Dostoyevsky
• Play, Dreams, and Imitation; Jean Piaget
• Enuma Elis; 900-200 BCE, Der babylonische Weltschöpfungsmythos Enuma Elisch - Kämmerer und Metzler translation
• Upanisads; 700-200 BCE, Oxford Classics - Pattrick Ollivelle translation
• The City of God, Augustine of Hippo, 5th century, Bettenson translation
• The Divine Names, Dionysius the Areopagite,
• The Incoherence of the Philosophers, al-Ghazali, 11th century
• The Philosophical Writings of Descartes
• Ethik (Ethics), Baruch de Spinoza, Gebhardt translation
• Candide, Voltaire, 1759, Penguin Classics
• Discourse on the Origins and Foundations of Inequality among Men, Rousseau
• Discourse on Political Economy, Rousseau
• On the Social Contract, Rousseau
• Emile, Rousseau
• On Writing, Steven King
• The Divine Comedy, Dante, 1321
• Name of the Rose, Umberto Eco, 1980
• Determined: Life without Free Will, Robert Sapolsky
• Three-Body Problem, Liu Cixin, 2008
• Paradies lost, John Milton, 1667
• Notes on Complexity, Neil Theise
• Rigor of Angels, William Eggington
• Excellent Advice for the Living, Kevin Kelly
• The New Essential Guide to Electronics in Shenzhen, https://www.bunniestudios.com/blog/?p=6886

In my experience, the higher the risk the higher the seniority to own a project. While that makes sense in general it led to situations where more junior members of a team were starved out of the opportunity to learn and grow. Being responsible for something that is above your comfort zone is what pushes you to the next level.

There is also the bus factor. If larger or risky projects stay with a few senior people a lot of the highly critical work is dependent on them. If they are unavailable, the team starts to scramble to pick up those tasks. In the end, we siloed a lot of knowledge and experience into a few members which in my experience never ended well for the team.

But I think it is an issue that is rather easy to fix. We already opened up roadmap planning to all members, so why not do the same for project lead responsibilities? I pitch an idea that is above my comfort zone but believe I can do it and so do other senior members of the team. In that case, I become the Driver and take on ownership(E1).

Responsibilities

But what responsibilities come with that role? It is not about building everything on your own, but it is about making sure we successfully iterate through the remaining steps of Ready, Learn, Do. That means a Driver makes sure:

• stakeholder communication happens,
• reports about the state of the project are shared regularly,
• members of the project team know what to work on next,
• that the project makes the expected progress,
• that we do not get stuck while making decisions (tiebreaker)

The Driver is also the go-to person when people outside the project have a question. In short, they act as a leader.

Read on

1. Dealing with uncertainty: Ready, Learn, Do
2. Pitching Ideas

Epilogue

(E1): The team and its leaders have to ensure a Driver is set up to succeed. If we agree I drive project X but they know I am not up to the task, even with their help, this will be a frustrating experience for all people involved.

When I introduced Ready, Learn, Do for software development (1) I left a hint of how it might also change team operations. Ready(ing) an idea means understanding its cost and value. So what we got is a way to transmit motivation to invest in a problem (or not). In other words, we got a pitch.

By using Ready, Learn, Do we bake roadmap planning for teams and organizations into the process. How that is done in detail is the focus of this post.

Get Ready … Pitch

You are a Product Owner and see an opportunity for a new feature. You take a day and collect as much information as you can to construct a value proposition and a rough map of potential space (2). During the next planning, it is go-time and you present your idea. Or maybe you are an engineer on the same team and you think it is time to revamp your deployment setup. So you go ahead, take some time, and ready your pitch.

The basic idea is that the discovery of opportunity is distributed across the team. No single lead is responsible for figuring out what comes next (E1). Instead, you leverage the experience and creativity of the team. From a junior engineer to the most senior member everyone can pitch in an idea for a project or task. Nothing is too big or too small.

When to Pitch?

In my experience, having some fixed points in your calendar is always good. Be it for 1-1s, reviews, or in this case pitching new ideas. I assume most teams have some kind of backlog refinement anyway. So why not use that? You come in, some people prepared and already shared the ideas they want to show, and now it is time to discuss them. Do you see more unknowns? Do you agree with the cost and value proposition?

If you agree, as a team, that it is a worthwhile effort go to the next step otherwise you, who presented the idea, put it aside. Maybe now is not the right time or there are some more points you have to consider. It could also mean that it is just not valuable enough to do which is also good to know.

How to Prioritize

Of course, there are almost always more good ideas than time to work on them. So what do you do with the rest? Just putting it all in a backlog means you create a graveyard. The number of ideas grows and most of them are stuck in there forever. So we prioritize and remove what gets too old.

Is this change impacting your team, other teams, or your users? Is its effort low or high? Is the impact low or high? There are rough qualitative measures that tell you where to place a task or project in value space.

Is feature A impacting your users a lot but to make it work will take months? We should probably do it but maybe focus on B first which is a low-hanging fruit in comparison. Or maybe you do some high-impact work that improves how you operate as a team. For me, there is no clear-cut rule on how to decide what is most important. In the end, it depends on your team’s context and it is something you have to reevaluate every time.

Based on that classification you can order your work and from here everyone just starts to pick from the top.

To address the graveyard problem we just have to add one constraint to this structure. Whatever gets older than X months is removed. What X you feel comfortable with depends on you. Maybe you move fast and 3 months is your limit. Or you are a bit more conservative and aim for 12 months instead. Whatever it is make it explicit and stick to that rule (E2).

Pitching upwards

As long as tasks stay small deciding within your team what to work on is fine but what if you try to commit to some months-long journey or you do need the support of other teams? In that case, you have to pitch upwards. If it is affecting your domain address the domain lead. If it is even bigger they have to bubble it up to the highest rank appropriate (E3).

And then there are those really large projects that are often shifts in how the product or company works. Often they come from the top and ripple down the organization. But at the beginning, I said that pitching allows a team to leverage the experience of all members. I believe the same is true for your whole organization. Why not open up the floor for big ideas for everyone and not just senior leadership?

What would need to change is to have some fixed point in your calendar where everyone can book a 5min slot to present their idea. From leadership to junior members. What counts is your idea and not your rank. Of course, that also requires that decision-makers join those meetings and are willing to commit time to ideas that look promising. The hurdle to do that should be lower tho when Ready, Learn, Do is applied.

Unfortunately, that last process I haven’t experienced or seen implemented anywhere so far but it is an idea I would like to try out at some point.

Coming to an end, the result of the Ready phase should be a pitch for your idea. A summary of the unknowns, costs, and values that could be gained. You might just do that in 10min because it is a small thing, or you want to go big and prepare a “real” pitch deck. In the end, the idea is that everyone can participate in setting the course of their team and organization.

Read on

1. Dealing with uncertainty: Ready, Learn, Do
2. Potential Space
3. Project Driver

Epilogue

(E1): They are still accountable tho. They have to make sure the team goes in the right direction. Now they just open up the floor for those kinds of discussions to all members.

(E2) Now you might say “But don’t we lose good ideas which we might implement later on?”. Maybe. In my experience, if it really is a good idea or issue that needs resolution, it comes back later anyway just that the context changed in a way that we can actually invest time in it.

Or it isn’t as worthwhile as you believe. If a task stays in your backlog for let’s say 12 months untouched is it really that valuable?

What I have soon almost everywhere is a backlog with hundreds of items and nobody really has an overview anymore of what is going on. So you go back and slug through the whole thing every now and then to figure out what is still needed. To me that was always more a distraction than it helped.

(E3): Before you pitch up make sure to pitch your idea within your team. That way you gain early feedback and the backing of your team when it comes to bringing it to the next level. Otherwise, there is a good chance that your pitch isn’t tuned in enough and might not receive the full appreciation.

As an aside, leads of a team, domain, etc should be responsible to figure out if a pitch needs buy-in from more senior leadership.

A marriage to hope and fear
That it may not sleep forever.
You pushed yourself too hard,
Lost control,
Look at its rearing head.

How magnificent its emergence

Out of order.

So sudden

Breaking through understanding,
Ripping it apart,
Losing knowing altogether.

Swallowing you alive,
Flooding your world with chaos,
And for that, you pay a bitter price.

Read on

• Dragon

In the beginning, we don’t have the full picture yet and the number of possible solutions is huge. Therefore our goal has to be to narrow down that space. For that, we first have to get Ready.

Ready

This step is about doing one’s homework. We have to understand what kind of problem we are dealing with. In the end, we should have a rough map of the terrain.

What does that mean in practice? Gather information and write them down. Talk to people who know, watch videos, read texts, and understand code. Do whatever is necessary to understand the problem but keep in mind to not waste too much time on it. In my experience, work that is heavy on learning and discovery tends to eat all your time and then some, therefore, commit to a deadline. Your understanding doesn’t have to be perfect. A rough sketch of potential space is enough for now.

By now you should know the following: * Is this problem solvable? Is there a potential path? * Is it worthwhile? What would change for the better and how? * What isn’t clear yet? * What guardrails exist? * What decisions need to be done? * Who are your stakeholders? * What are your resources?

And with that, we reached the first decision point. After you wrote down your findings you, your team, or the organization have to make a decision if it makes sense to invest more time into this endeavor.

Learn

Once you got the go take all your findings and fill in the holes and again we commit to a deadline.

The point of this step is to narrow down potential space even more so we end up with a handful of paths or even just one toward a solution. It is about resolving assumptions and unknowns and reducing risk (aka surprises). It is also another hurdle to check if we actually focus on the right thing.

For that we build cheap prototypes we throw away in the end. We also talk to people again to remove decision points we identified while we got Ready or showed up in the meantime.

By the end of Learn you should know the following: * What does the solution look like? * How do we get there? * How much time will it roughly take? * What will change for the better and how?

You should also have all the necessary resources at this point. That can be a budget, help from other teams, access, etc.

Another decision point is reached. Do we still want to continue? Is it worth our time?

Do

If the answer is still “yes“ we go right into the last phase: Do. Here, we will create the actual solution. But keep in mind to track new unknowns that pop up in the meantime. It has to be transparent to you and everyone else if we misjudged the terrain and have to do more and more Learn(ing). If that is the case, a reevaluation is due, and a decision of whether we still want to continue.

To make sure we have that transparency we report state on a regular basis, for example, every week on a certain day. There is a balance to be struck about the frequency here. Feel out what works for you.

Another signal we get is when we reach the estimated end of the project. Did we finish it already? Will it be done in time or do we miss the mark and have to continue? Coming closer to the end the answer shouldn’t be a surprise if we had regular reports. Now we have yet another decision point. And don’t fall for the lure of sunken cost. It can still be better to just stop and accept that it didn’t work out instead of hemorrhaging more and more of your time. You learned something and that has to be enough.

But let’s assume it all worked out in the end and you get your solution. You are not done yet. It still has to be rollout and you have to prove that this effort was worthwhile. Here, the question “What will change for the better and how?” comes in handy. Release your solution to your users and measure what happens. Did it work? This is yet another important signal. For one, it gives the final validation for our value proposition. But it also tells us if our process works correctly.

If we didn’t make it rinse and repeat. Ready yourself and make a point that it is worthwhile to continue and sketch out a new potential space.

Apply it Everywhere

I used this or similar approaches for different-sized work and at different stages. For example, when you want to fix something which you think takes you roughly 2 days you might hit up a colleague and discuss the What, How, and Why. That might take 15min and you covered your get Ready part. Now you answer those remaining questions like “How can I reproduce the issue in a test?” (“Learn”) and finally you fix it (“Do”). All the while you set yourself some time limits.

And then you have those large projects that take months to finish. The same approach applies now just on multiple levels. While your project itself goes through those phases you will work on different tasks or sub-projects all in their own state. You can repeat that down to a single task.

Another thing where you can apply it is in “normal” team operations. Instead of the usual refinement, why aren’t you picking up on some idea you had and making it ready? When you meet, show your sketch; when it sticks, let’s move into Learn and Do. This way everyone can contribute to the roadmap and influence where the team goes.

This is just to say it is turtles all the way down. I think you can apply the same approach on many levels successfully.

To wrap it up, to better deal with uncertainty and its symptoms like feature creep or never-ending projects Ready, Learn, Do might be a good path out of this hole. It limits the time you invest and gives you as a team transparency where you are at any moment.

Do you think that makes sense? Does this approach bring something new to the table? Let me know

Read on

1. Potential Space
2. Leadership and Management
3. Idea Pitches