Ich hätte nicht erwartet, dass ein einziger Satz in der Dokumentation meine Sicht auf das gesamte Diagramm verändert.
Es war der Hinweis, dass es keinen Off-Chain-Server im kritischen Pfad gibt.
Ich habe das zuerst gelesen und bin dann zurück in den Workflow gegangen und habe ihn erneut von vorn verfolgt.
Beim zweiten Mal hat es sich anders angefühlt.
Ich habe den Workflow beim zweiten Durchlauf von Anfang an verfolgt, statt vorzuspringen. So habe ich verstanden, dass ich auf diese Weise viel mehr mitgenommen habe.
Das ist etwas, das ich an technischer Dokumentation mag.
Manchmal bringt ein kleines Detail dich dazu, die gleiche Seite noch einmal zu lesen – und das zweite Lesen ist normalerweise nützlicher als das erste.
So war es für mich bei Newton Protocol.
Ich habe die Seite nicht geschlossen, weil ich an eine Funktion dachte.
Ich habe sie geschlossen mit dem Gedanken, warum der Workflow so angeordnet war, wie er es ist.
Für mich ist das normalerweise ein Zeichen dafür, dass die Dokumentation das Design gut erklärt hat – statt es nur zu beschreiben.
@NewtonProtocol
$NEWT
#Newt
Es war der Hinweis, dass es keinen Off-Chain-Server im kritischen Pfad gibt.
Ich habe das zuerst gelesen und bin dann zurück in den Workflow gegangen und habe ihn erneut von vorn verfolgt.
Beim zweiten Mal hat es sich anders angefühlt.
Ich habe den Workflow beim zweiten Durchlauf von Anfang an verfolgt, statt vorzuspringen. So habe ich verstanden, dass ich auf diese Weise viel mehr mitgenommen habe.
Das ist etwas, das ich an technischer Dokumentation mag.
Manchmal bringt ein kleines Detail dich dazu, die gleiche Seite noch einmal zu lesen – und das zweite Lesen ist normalerweise nützlicher als das erste.
So war es für mich bei Newton Protocol.
Ich habe die Seite nicht geschlossen, weil ich an eine Funktion dachte.
Ich habe sie geschlossen mit dem Gedanken, warum der Workflow so angeordnet war, wie er es ist.
Für mich ist das normalerweise ein Zeichen dafür, dass die Dokumentation das Design gut erklärt hat – statt es nur zu beschreiben.
@NewtonProtocol
$NEWT
#Newt
